Deploy draft release

Deploy a draft release

POST /ai/releases/deployDraft

Deploy draft release

cURL

curl --request POST \
  --url https://api.getcargo.io/v1/ai/releases/deployDraft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "actions": [
    {
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "isBulkAllowed": true,
      "config": {},
      "kind": "<string>",
      "toolUuid": "<string>",
      "templateSlug": "<string>"
    }
  ],
  "mcpClients": [
    {
      "kind": "<string>",
      "name": "<string>",
      "url": "<string>",
      "authentication": {
        "issuedAt": "<string>",
        "accessToken": "<string>",
        "expiresIn": 123,
        "refreshToken": "<string>",
        "scope": "<string>",
        "tokenType": "<string>",
        "clientId": "<string>"
      },
      "disabledToolSlugs": [
        "<string>"
      ]
    }
  ],
  "resources": [
    {
      "kind": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "integrationSlug": "<string>",
      "modelUuid": "<string>",
      "filter": {
        "groups": [
          "<unknown>"
        ]
      },
      "selectedColumnSlugs": [
        "<string>"
      ],
      "limit": 123,
      "prompt": "<string>"
    }
  ],
  "capabilities": [
    {
      "slug": "<string>"
    }
  ],
  "suggestedActions": [
    {
      "text": "<string>",
      "actions": [
        {
          "slug": "<string>"
        }
      ]
    }
  ],
  "integrationSlug": "<string>",
  "languageModelSlug": "<string>",
  "systemPrompt": "<string>",
  "withReasoning": true,
  "temperature": 123,
  "maxSteps": 123,
  "connectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "version": "<string>",
  "description": "<string>",
  "options": {
    "connectorUuidsByIntegrationSlug": {},
    "modelUuidsByIntegrationSlug": {}
  }
}
'

200

{
  "release": {
    "uuid": "<string>",
    "parentUuid": "<string>",
    "workspaceUuid": "<string>",
    "userUuid": "<string>",
    "agentUuid": "<string>",
    "description": "<string>",
    "templateSlug": "<string>",
    "version": "<string>",
    "actions": [
      {
        "name": "<string>",
        "slug": "<string>",
        "description": "<string>",
        "isBulkAllowed": true,
        "config": {},
        "kind": "<string>",
        "toolUuid": "<string>",
        "templateSlug": "<string>"
      }
    ],
    "resources": [
      {
        "kind": "<string>",
        "name": "<string>",
        "slug": "<string>",
        "description": "<string>",
        "integrationSlug": "<string>",
        "modelUuid": "<string>",
        "filter": {
          "groups": [
            "<unknown>"
          ]
        },
        "selectedColumnSlugs": [
          "<string>"
        ],
        "limit": 123,
        "prompt": "<string>"
      }
    ],
    "capabilities": [
      {
        "slug": "<string>"
      }
    ],
    "suggestedActions": [
      {
        "text": "<string>",
        "actions": [
          {
            "slug": "<string>"
          }
        ]
      }
    ],
    "systemPrompt": "<string>",
    "withReasoning": true,
    "temperature": 123,
    "maxSteps": 123,
    "integrationSlug": "<string>",
    "connectorUuid": "<string>",
    "languageModelSlug": "<string>",
    "mcpClients": [
      {
        "kind": "<string>",
        "name": "<string>",
        "url": "<string>",
        "authentication": {
          "issuedAt": "<string>",
          "accessToken": "<string>",
          "expiresIn": 123,
          "refreshToken": "<string>",
          "scope": "<string>",
          "tokenType": "<string>",
          "clientId": "<string>"
        },
        "disabledToolSlugs": [
          "<string>"
        ]
      }
    ],
    "deployedAt": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Authorizations

Authorization · string · header · required

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

Body

application/json

Request body schema.

agentUuid · string<uuid> · required

Agent identifier.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

actions · Actions · object[] · required

Actions available in the release.

Option 1

Option 2

Option 3

Show child attributes

mcpClients · MCP clients · object[] · required

MCP clients available in the release.

Option 1

Option 2

Show child attributes

resources · Resources · object[] · required

Resources available in the release.

Option 1

Option 2

Show child attributes

capabilities · Capabilities · object[] · required

Capabilities available in the release.

Show child attributes

suggestedActions · Suggested actions · object[] · required

Suggested actions to include.

Show child attributes

integrationSlug · string · required

Integration identifier.

languageModelSlug · string · required

Language model identifier.

systemPrompt · string

System prompt for the release.

withReasoning · boolean

Whether to include reasoning.

temperature · number

Sampling temperature.

maxSteps · number

Maximum number of steps.

connectorUuid · string<uuid>

Connector identifier.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

version · string

Release version (small semver, e.g. 1.2.3).

Pattern: ^(0|[1-9]\d{0,3})\.(0|[1-9]\d{0,3})\.(0|[1-9]\d{0,4})$

description · string

Release description.

options · Options · object

Release options.

Show child attributes

Response

200

application/json

Successful response

release · Release · object · required

Deployed release details.

Show child attributes