Skip to main content
POST
/
ai
/
releases
/
deployDraft
Deploy draft release
curl --request POST \
  --url https://api.getcargo.io/v1/ai/releases/deployDraft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentUuid": "<string>",
  "tools": [
    {
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "isBulkAllowed": true,
      "config": {},
      "kind": "<string>",
      "toolUuid": "<string>",
      "templateSlug": "<string>"
    }
  ],
  "mcpClients": [
    {
      "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": {
        "conjonction": "or",
        "groups": [
          "<unknown>"
        ]
      },
      "selectedColumnSlugs": [
        "<string>"
      ],
      "limit": 123,
      "prompt": "<string>"
    }
  ],
  "capabilities": [
    {
      "slug": "<string>"
    }
  ],
  "suggestedActions": [
    {
      "text": "<string>",
      "tools": [
        {
          "slug": "<string>"
        }
      ]
    }
  ],
  "integrationSlug": "<string>",
  "languageModelSlug": "<string>",
  "version": "<string>",
  "systemPrompt": "<string>",
  "withReasoning": true,
  "temperature": 123,
  "maxSteps": 123,
  "connectorUuid": "<string>",
  "description": "<string>",
  "options": {
    "connectorUuidsByIntegrationSlug": {},
    "modelUuidsByIntegrationSlug": {}
  }
}
'
{
  "release": {
    "uuid": "<string>",
    "parentUuid": "<string>",
    "workspaceUuid": "<string>",
    "userUuid": "<string>",
    "agentUuid": "<string>",
    "description": "<string>",
    "templateSlug": "<string>",
    "version": "<string>",
    "status": "draft",
    "tools": [
      {
        "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": {
          "conjonction": "or",
          "groups": [
            "<unknown>"
          ]
        },
        "selectedColumnSlugs": [
          "<string>"
        ],
        "limit": 123,
        "prompt": "<string>"
      }
    ],
    "capabilities": [
      {
        "slug": "<string>"
      }
    ],
    "suggestedActions": [
      {
        "text": "<string>",
        "tools": [
          {
            "slug": "<string>"
          }
        ]
      }
    ],
    "systemPrompt": "<string>",
    "withReasoning": true,
    "temperature": 123,
    "maxSteps": 123,
    "integrationSlug": "<string>",
    "connectorUuid": "<string>",
    "languageModelSlug": "<string>",
    "mcpClients": [
      {
        "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
required

Agent identifier.

tools
Tools · object[]
required

Tools available in the release.

mcpClients
MCP clients · object[]
required

MCP clients available in the release.

resources
Resources · object[]
required

Resources available in the release.

capabilities
Capabilities · object[]
required

Capabilities available in the release.

suggestedActions
Suggested actions · object[]
required

Suggested actions to include.

integrationSlug
string
required

Integration identifier.

languageModelSlug
string
required

Language model identifier.

version
string
required

Release version.

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

Connector identifier.

description
string

Release description.

options
Options · object

Release options.

Response

Successful response

release
Release · object
required

Deployed release details.