Skip to main content
POST
Deploy agent version

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Headers

Idempotency-Key
string
required

Reuse this key with identical inputs when retrying. Use a new key for a new operation.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_.:-]+$
Example:

"review-123-v1"

Path Parameters

app_id
string
required

The imported app whose connected repository the agent may read.

Pattern: ^[a-f0-9]{24}$
Example:

"6820f3a4e7b91d003c45a1f1"

Body

application/json
package
AgentManifest · object
required

The immutable agent manifest to deploy.

Response

Successful Response

id
string
required
app_id
string
required
organization_id
string
required
package_digest
string
required
name
string
required
output_contract
string
required
disabled
boolean
required
created_date
string
required