POST
/
agents
/
{agentId}
/
deployments
Create an agent deployment
curl --request POST \
  --url https://your_salambo_base_url/api/v1/agents/{agentId}/deployments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "runtimeConfig": {
    "egressAllowlist": [
      "<string>"
    ],
    "otlpEndpointOverride": "<string>",
    "otelIncludeContentOverride": true
  },
  "sourceKind": "<string>",
  "repositoryUrl": "<string>",
  "repositoryFullName": "<string>",
  "branch": "<string>",
  "commitSha": "<string>",
  "commitUrl": "<string>",
  "commitMessage": "<string>",
  "deployMessage": "<string>",
  "sandboxImageMode": "custom",
  "brainSummary": {},
  "sandboxSummary": {},
  "metadata": {}
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "<string>",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "version_number": 123,
  "runtime_config": {
    "version": 123,
    "sandbox": {
      "egress": {
        "allowlist": [
          "<string>"
        ]
      },
      "workspace": {}
    },
    "telemetry": {
      "endpoint": "<string>",
      "includeContent": true
    }
  },
  "created_at": 123,
  "updated_at": 123,
  "source": {
    "kind": "<string>",
    "repository_url": "<string>",
    "repository_full_name": "<string>",
    "branch": "<string>",
    "commit_sha": "<string>",
    "commit_url": "<string>",
    "commit_message": "<string>",
    "deploy_message": "<string>"
  },
  "deployed_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_archive": {},
  "manifest": {},
  "image": {},
  "sandbox_image": {
    "base_image": {}
  },
  "failed_stage": "<string>",
  "brain_summary": {},
  "sandbox_summary": {},
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "metadata": {},
  "finished_at": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agentId
string<uuid>
required

Body

application/json
​
runtimeConfig
object
required
​
sourceKind
string
Maximum string length: 64
​
repositoryUrl
string<uri> | null
​
repositoryFullName
string | null
Maximum string length: 256
​
branch
string | null
Maximum string length: 256
​
commitSha
string | null
Maximum string length: 128
​
commitUrl
string<uri> | null
​
commitMessage
string | null
Maximum string length: 500
​
deployMessage
string | null
Maximum string length: 500
​
sandboxImageMode
enum<string>
default:custom

Compatibility default is custom when omitted. Current source-deployment clients should send the intended mode explicitly.

Available options:
managed,
custom
​
brainSummary
object
​
sandboxSummary
object
​
metadata
object

Response

Created deployment

​
id
string<uuid>
required
​
object
string
required
Allowed value: "agent_deployment"
​
agent_id
string<uuid>
required
​
version_number
integer | null
required
​
runtime_config
object
required
​
status
enum<string>
required
Available options:
queued,
uploading_source,
source_uploaded,
building_image,
pushing_image,
preparing_runtime,
ready,
failed,
cancelled
​
created_at
integer
required
​
updated_at
integer
required
​
source
object
​
deployed_by_user_id
string<uuid> | null
​
source_archive
object
​
manifest
object
​
image
object
​
sandbox_image
object
​
sandbox_region
enum<string> | null
Available options:
us,
eu,
null
​
failed_stage
string | null
​
brain_summary
object
​
sandbox_summary
object
​
error
object
​
metadata
object
​
finished_at
integer | null