Skip to main content
Unary · Agents Starts (or triggers) an agent run using a provided agent. Use this method to:
  • Launch an agent based on a known agent

Examples

  • Start an agent with a project ID:

Endpoint

Send a Bearer token as described in Authentication. If your organization uses a custom management-plane domain, replace https://app.ona.com with that domain.

Request example

Request

gitpod.v1.StartAgentRequest

Response

gitpod.v1.StartAgentResponse
gitpod.v1.AgentCodeContext
gitpod.v1.AgentCodeContext.ContextURL
CodexSettings contains settings consumed only by the Codex app agent.gitpod.v1.CodexSettings
PullRequest represents pull request metadata from source control systems. This message is used across workflow triggers, executions, and agent contexts to maintain consistent PR information throughout the system.gitpod.v1.PullRequest
gitpod.v1.TurnOptions
AgentMode defines the operational mode of an agent
CodexOpenAIModel is the static allowlist of concrete OpenAI models that the Codex app runtime can select through Ona’s Codex picker.
CodexReasoningEffort is the static allowlist of reasoning efforts supported by the Codex app runtime.
CodexServiceTier is the static allowlist of service tiers supported by the Codex app runtime.
Current state of the pull request