Skip to main content
PUT
/
ai
/
releases
/
updateDraft
Update draft release
curl --request PUT \
  --url https://api.getcargo.io/v1/ai/releases/updateDraft \
  --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>"
        }
      ]
    }
  ],
  "systemPrompt": "<string>",
  "withReasoning": true,
  "temperature": 123,
  "maxSteps": 123,
  "integrationSlug": "<string>",
  "connectorUuid": "<string>",
  "languageModelSlug": "<string>",
  "parentUuid": "<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[]

Tools available in the draft release.

mcpClients
MCP clients · object[]

MCP clients available in the draft release.

resources
Resources · object[]

Resources available in the draft release.

capabilities
Capabilities · object[]

Capabilities available in the draft release.

suggestedActions
Suggested actions · object[]

Suggested actions to include.

systemPrompt
string

System prompt for the draft release.

withReasoning
boolean

Whether to include reasoning.

temperature
number

Sampling temperature.

maxSteps
number

Maximum number of steps.

integrationSlug
string

Integration identifier.

connectorUuid
string

Connector identifier.

languageModelSlug
string

Language model identifier.

parentUuid
string

Parent release identifier.

options
Options · object

Draft release options.

Response

Successful response

release
Release · object
required

Updated draft release details.