Ona

https://ona.com/docs
Admin
Ona is a development platform providing secure, automated development environments and background...
Tokens:1,003,099
Snippets:7,828
Trust Score:9.2
Update:1 day ago
Show doc for...
Tokens:
Raw
### Exec examples

Source: https://ona.com/docs/ona/environments/agent-environments

Examples of running builds, tests, commands in a specific directory, and getting structured output.

```bash
# Run a build
ona environment exec <environment-id> -- make build

# Run tests with a longer timeout
ona environment exec <environment-id> --timeout 300 -- npm test

# Run in a specific directory
ona environment exec <environment-id> --working-dir /workspace/myproject -- cargo test

# Get structured output for parsing
ona environment exec <environment-id> -o json -- echo hello
```

--------------------------------

### Request example: Go

Source: https://ona.com/docs/api-reference/generated/organization/list-scim-configurations

Go example using connectrpc.com/connect and gitpod-sdk-go to create a client and call ListSCIMConfigurations.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListSCIMConfigurationsRequest{
		Pagination: &gitpodpb.PaginationRequest{
			PageSize: 1,
		},
	})
	response, err := ona.Services.Organization.ListSCIMConfigurations(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Configure JetBrains plugins in devcontainer.json

Source: https://ona.com/docs/changelog

Example devcontainer.json configuration that specifies JetBrains plugins by their IDs from the JetBrains Marketplace. Use this to standardize plugin installation across development environments, eliminating manual setup.

```json
{
	"name": "My Project",
	"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
	"customizations": {
		"jetbrains": {
			"plugins": ["org.intellij.plugins.hcl", "com.intellij.kubernetes"]
		}
	}
}
```

--------------------------------

### Get URL with return path: email and returnTo example

Source: https://ona.com/docs/api-reference/generated/account/get-sso-login-url

Example request body for getting SSO URL with a specific return location.

```plaintext
email: "user@company.com"
returnTo: "https://gitpod.io/workspaces"
```

--------------------------------

### Request example in Go

Source: https://ona.com/docs/api-reference/generated/service-account/create-service-account-access-token

Go example using connectrpc.com/connect and gitpod-sdk-go to create a service account access token.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateServiceAccountAccessTokenRequest{
		ServiceAccountId: "<service-account-id>",
	})
	response, err := ona.Services.ServiceAccount.CreateServiceAccountAccessToken(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example for CreatePrebuildLogsToken

Source: https://ona.com/docs/api-reference/generated/prebuild/create-prebuild-logs-token

Go client example using the gitpod-sdk-go to create a prebuild logs token.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreatePrebuildLogsTokenRequest{
		PrebuildId: "<prebuild-id>",
	})
	response, err := ona.Services.Prebuild.CreatePrebuildLogsToken(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get webhook secret example

Source: https://ona.com/docs/api-reference/generated/webhook/get-webhook-secret

Example of a webhook ID used to retrieve the webhook secret.

```plaintext
webhookId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
```

--------------------------------

### Get Runner: Python request example

Source: https://ona.com/docs/api-reference/generated/runner/get-runner

Python example using the ona_sdk to call get_runner.

```python
import gitpod.v1.runner_pb2 as runner_pb2
from ona_sdk import create_client_from_env

ona = create_client_from_env()
request = runner_pb2.GetRunnerRequest(
    runner_id="<runner-id>",
)
response = ona.services.runner.get_runner(request)
print(response)
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/environment/create-environment-access-token

Go client example using gitpod-sdk-go to create an environment access token.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateEnvironmentAccessTokenRequest{
		EnvironmentId: "<environment-id>",
	})
	response, err := ona.Services.Environment.CreateEnvironmentAccessToken(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/project/create-project-from-environment

Go client example using connectrpc.com/connect and gitpod-sdk-go to create a project from an environment. Prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateProjectFromEnvironmentRequest{
		Name: "<name>",
	})
	response, err := ona.Services.Project.CreateProjectFromEnvironment(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get class details example

Source: https://ona.com/docs/api-reference/generated/runner-configuration/get-environment-class

Example input for the GetEnvironmentClass request, showing the environmentClassId field.

```plaintext
environmentClassId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
```

--------------------------------

### ListPrebuilds Go request

Source: https://ona.com/docs/api-reference/generated/prebuild/list-prebuilds

Go example using gitpod-sdk-go to call ListPrebuilds. Creates a client from environment and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListPrebuildsRequest{
		Pagination: &gitpodpb.PaginationRequest{
			PageSize: 1,
		},
	})
	response, err := ona.Services.Prebuild.ListPrebuilds(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get an audit-log entry (example ID)

Source: https://ona.com/docs/api-reference/generated/event/get-audit-log

Shows the auditLogEntryId value used in the examples on this page.

```plaintext
auditLogEntryId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
```

--------------------------------

### Get prompt details example

Source: https://ona.com/docs/api-reference/generated/agent/get-prompt

Example of a promptId value used to retrieve prompt details.

```text
promptId: "07e03a28-65a5-4d98-b532-8ea67b188048"
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/account/list-login-providers

Go client example using connectrpc.com/connect and the gitpod-sdk-go. Creates a client from environment, sends a ListLoginProvidersRequest with pageSize 1, and prints the response.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListLoginProvidersRequest{
		Pagination: &gitpodpb.PaginationRequest{
			PageSize: 1,
		},
	})
	response, err := ona.Services.Account.ListLoginProviders(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}

```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/create-organization

Go example using connectrpc.com/connect and the gitpod-sdk-go to create an organization. Requires the SDK and environment variables for authentication.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateOrganizationRequest{
		Name: "<name>",
	})
	response, err := ona.Services.Organization.CreateOrganization(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Runner: Go request example

Source: https://ona.com/docs/api-reference/generated/runner/get-runner

Go example using connectrpc.com/connect and gitpod-sdk-go to call GetRunner.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.GetRunnerRequest{
		RunnerId: "<runner-id>",
	})
	response, err := ona.Services.Runner.GetRunner(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Runner: TypeScript request example

Source: https://ona.com/docs/api-reference/generated/runner/get-runner

TypeScript example using @bufbuild/protobuf and @gitpod/sdk to call getRunner.

```typescript
import { create } from "@bufbuild/protobuf";
import { createClientFromEnv } from "@gitpod/sdk";
import { GetRunnerRequestSchema } from "@gitpod/sdk/gitpod/v1/runner_pb";

async function main() {
  const ona = createClientFromEnv();
  const request = create(GetRunnerRequestSchema, {
    runnerId: "<runner-id>",
  });
  const response = await ona.services.runner.getRunner(request);
  console.log(response);
}

main().catch(console.error);
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/update-scim-configuration

Go example using connectrpc.com/connect and gitpod-sdk-go to call UpdateSCIMConfiguration. Creates a client from environment and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.UpdateSCIMConfigurationRequest{
		ScimConfigurationId: "<scim-configuration-id>",
	})
	response, err := ona.Services.Organization.UpdateSCIMConfiguration(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/project/create-project

Go client example using gitpod-sdk-go to create a project.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateProjectRequest{
		Initializer: &gitpodpb.EnvironmentInitializer{
			Specs: []*gitpodpb.EnvironmentInitializer_Spec{&gitpodpb.EnvironmentInitializer_Spec{
				Spec: &gitpodpb.EnvironmentInitializer_Spec_Git{
					Git: &gitpodpb.GitInitializer{
						RemoteUri: "https://example.com",
					},
				},
			}},
		},
	})
	response, err := ona.Services.Project.CreateProject(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get invite summary example

Source: https://ona.com/docs/api-reference/generated/organization/get-organization-invite-summary

Example of an invite ID used to retrieve organization information from an invite.

```text
inviteId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
```

--------------------------------

### Get Preference: preferenceId example

Source: https://ona.com/docs/api-reference/generated/user/get-preference

Shows an example preferenceId value used to retrieve a specific user preference.

```text
preferenceId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/runner/list-scm-organizations

Go example using connectrpc.com/connect and gitpod-sdk-go to call ListSCMOrganizations. Creates a client from environment and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListSCMOrganizationsRequest{
		RunnerId: "<runner-id>",
	})
	response, err := ona.Services.Runner.ListSCMOrganizations(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get login URL: email example

Source: https://ona.com/docs/api-reference/generated/account/get-sso-login-url

Example request body for retrieving SSO URL for an email domain.

```plaintext
email: "user@company.com"
```

--------------------------------

### StartWorkflow request example: Go

Source: https://ona.com/docs/api-reference/generated/workflow/start-workflow

Go client example using connectrpc.com/connect and the gitpod-sdk-go to create a client and call StartWorkflow.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.StartWorkflowRequest{
		WorkflowId: "<workflow-id>",
	})
	response, err := ona.Services.Workflow.StartWorkflow(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/list-terms-of-service-acceptances

Go example using connectrpc.com/connect and gitpod-sdk-go to call ListTermsOfServiceAcceptances. Creates a client from environment variables and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListTermsOfServiceAcceptancesRequest{
		OrganizationId: "<organization-id>",
	})
	response, err := ona.Services.Organization.ListTermsOfServiceAcceptances(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Install Go SDK with go get

Source: https://ona.com/docs/ona/integrations/sdk

Install the github.com/gitpod-io/gitpod-sdk-go module for Go. Requires Go 1.25 or later.

```bash
go get github.com/gitpod-io/gitpod-sdk-go
```

--------------------------------

### Service example with database and backend

Source: https://ona.com/docs/ona/reference/ona-config-schema

Example service definitions for a PostgreSQL database and an application backend. The database service uses lifecycle commands start, ready, and stop. The backend service uses a start command and is triggered postEnvironmentStart.

```yaml
services:
  database:
    name: PostgreSQL
    description: The backend database
    triggeredBy:
      - postEnvironmentStart
    commands:
      start: docker run --rm --name database postgres:latest
      ready: docker exec database pg_isready
      stop: docker stop database

  backend:
    name: Application Backend
    description: The application backend
    role: default
    triggeredBy:
      - postEnvironmentStart
    commands:
      start: cd backend && go run main.go
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/project/create-project-policy

Go example using connectrpc.com/connect and the gitpod-sdk-go to create a project policy. Creates a client from environment, sends a request, and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.CreateProjectPolicyRequest{
		ProjectId: "<project-id>",
	})
	response, err := ona.Services.Project.CreateProjectPolicy(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/runner-configuration/update-environment-class

Go example using connectrpc.com/connect and the gitpod-sdk-go to call UpdateEnvironmentClass.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.UpdateEnvironmentClassRequest{
		EnvironmentClassId: "<environment-class-id>",
	})
	response, err := ona.Services.RunnerConfiguration.UpdateEnvironmentClass(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Account Go Example

Source: https://ona.com/docs/api-reference/generated/account/get-account

Go example using the gitpod-sdk-go to call GetAccount. Requires the SDK and environment variables.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.GetAccountRequest{})
	response, err := ona.Services.Account.GetAccount(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/list-terms-of-service-versions

Go client example using connectrpc.com/connect and gitpod-sdk-go. Creates a client from environment, sends a ListTermsOfServiceVersions request, and prints the response.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListTermsOfServiceVersionsRequest{
		OrganizationId: "<organization-id>",
	})
	response, err := ona.Services.Organization.ListTermsOfServiceVersions(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Account TypeScript Example

Source: https://ona.com/docs/api-reference/generated/account/get-account

TypeScript example using @gitpod/sdk to call getAccount. Requires the SDK and environment variables.

```typescript
import { create } from "@bufbuild/protobuf";
import { createClientFromEnv } from "@gitpod/sdk";
import { GetAccountRequestSchema } from "@gitpod/sdk/gitpod/v1/account_pb";

async function main() {
  const ona = createClientFromEnv();
  const request = create(GetAccountRequestSchema, {});
  const response = await ona.services.account.getAccount(request);
  console.log(response);
}

main().catch(console.error);
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/list-domain-verifications

Go example using the gitpod-sdk-go package to call ListDomainVerifications. Creates a client from environment and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListDomainVerificationsRequest{
		OrganizationId: "<organization-id>",
	})
	response, err := ona.Services.Organization.ListDomainVerifications(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}

```

--------------------------------

### Get Account Python Example

Source: https://ona.com/docs/api-reference/generated/account/get-account

Python example using the ona_sdk to call get_account. Requires the SDK and environment variables.

```python
import gitpod.v1.account_pb2 as account_pb2
from ona_sdk import create_client_from_env

ona = create_client_from_env()
request = account_pb2.GetAccountRequest()
response = ona.services.account.get_account(request)
print(response)
```

--------------------------------

### Get Integration Go Request

Source: https://ona.com/docs/api-reference/generated/integration/get-integration

Go example using gitpod-sdk-go to get integration details. Requires the SDK and environment variables for authentication.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.GetIntegrationRequest{
		Id: "<id>",
	})
	response, err := ona.Services.Integration.GetIntegration(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/webhook/update-webhook

Go client example using connectrpc.com/connect and gitpod-sdk-go. Creates a client from environment, builds an UpdateWebhookRequest, and calls UpdateWebhook.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.UpdateWebhookRequest{
		WebhookId: "<webhook-id>",
	})
	response, err := ona.Services.Webhook.UpdateWebhook(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Integration TypeScript Request

Source: https://ona.com/docs/api-reference/generated/integration/get-integration

TypeScript example using @gitpod/sdk to get integration details. Requires the SDK and environment variables for authentication.

```typescript
import { create } from "@bufbuild/protobuf";
import { createClientFromEnv } from "@gitpod/sdk";
import { GetIntegrationRequestSchema } from "@gitpod/sdk/gitpod/v1/integration_pb";

async function main() {
  const ona = createClientFromEnv();
  const request = create(GetIntegrationRequestSchema, {
    id: "<id>",
  });
  const response = await ona.services.integration.getIntegration(request);
  console.log(response);
}

main().catch(console.error);
```

--------------------------------

### ListPrompts request example in Go

Source: https://ona.com/docs/api-reference/generated/agent/list-prompts

Go example using gitpod-sdk-go to list prompts. Creates a client from environment and calls ListPrompts with a pagination request.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListPromptsRequest{
		Pagination: &gitpodpb.PaginationRequest{
			PageSize: 1,
		},
	})
	response, err := ona.Services.Agent.ListPrompts(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/runner-configuration/update-llm-integration

Go client example using connectrpc.com/connect and gitpod-sdk-go. Creates a client from environment and calls UpdateLLMIntegration.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	 ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.UpdateLLMIntegrationRequest{
		Id: "<id>",
	})
	response, err := ona.Services.RunnerConfiguration.UpdateLLMIntegration(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Get Integration Python Request

Source: https://ona.com/docs/api-reference/generated/integration/get-integration

Python example using the ona_sdk to get integration details. Requires the SDK and environment variables for authentication.

```python
import gitpod.v1.integration_pb2 as integration_pb2
from ona_sdk import create_client_from_env

ona = create_client_from_env()
request = integration_pb2.GetIntegrationRequest(
    id="<id>",
)
response = ona.services.integration.get_integration(request)
print(response)
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/workflow/get-workflow-webhook-secret

Go example using gitpod-sdk-go to get the webhook secret. Creates a client from environment and calls the workflow service.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.GetWorkflowWebhookSecretRequest{
		WorkflowId: "<workflow-id>",
	})
	response, err := ona.Services.Workflow.GetWorkflowWebhookSecret(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### Go request example

Source: https://ona.com/docs/api-reference/generated/organization/list-members

Go example using connectrpc.com/connect and gitpod-sdk-go to call ListMembers. Creates a client from environment and prints the response message.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.ListMembersRequest{
		OrganizationId: "<organization-id>",
	})
	response, err := ona.Services.Organization.ListMembers(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```

--------------------------------

### GetPrompt request example (Go)

Source: https://ona.com/docs/api-reference/generated/agent/get-prompt

Go example using connectrpc.com/connect and gitpod-sdk-go to call GetPrompt.

```go
package main

import (
	"context"
	"fmt"
	"log"

	"connectrpc.com/connect"
	"github.com/gitpod-io/gitpod-sdk-go/sdk"
	gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1"
)

func main() {
	ona, err := sdk.NewFromEnv()
	if err != nil {
		log.Fatal(err)
	}

	request := connect.NewRequest(&gitpodpb.GetPromptRequest{
		PromptId: "<prompt-id>",
	})
	response, err := ona.Services.Agent.GetPrompt(context.Background(), request)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(response.Msg)
}
```
Tokens:
Raw