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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "actions": [
    {
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "isBulkAllowed": true,
      "config": {},
      "kind": "<string>",
      "toolUuid": "<string>",
      "templateSlug": "<string>",
      "waitUntilFinished": true
    }
  ],
  "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>",
      "isReadOnly": true
    }
  ],
  "capabilities": [
    {
      "slug": "<string>",
      "config": {}
    }
  ],
  "suggestedActions": [
    {
      "text": "<string>",
      "actions": [
        {
          "slug": "<string>"
        }
      ]
    }
  ],
  "systemPrompt": "<string>",
  "withReasoning": true,
  "temperature": 123,
  "maxSteps": 123,
  "integrationSlug": "<string>",
  "connectorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "languageModelSlug": "<string>",
  "parentUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "output": {
    "type": "<string>"
  },
  "heartbeat": {
    "intervalMinutes": 123,
    "maxMessages": 123,
    "prompt": "<string>"
  },
  "evaluator": {
    "rubric": "<string>",
    "threshold": 0.5
  },
  "options": {
    "connectorUuidsByIntegrationSlug": {},
    "modelUuidsByIntegrationSlug": {}
  }
}
'
{
  "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>",
        "waitUntilFinished": true
      }
    ],
    "resources": [
      {
        "kind": "<string>",
        "name": "<string>",
        "slug": "<string>",
        "description": "<string>",
        "integrationSlug": "<string>",
        "modelUuid": "<string>",
        "filter": {
          "groups": [
            "<unknown>"
          ]
        },
        "selectedColumnSlugs": [
          "<string>"
        ],
        "limit": 123,
        "prompt": "<string>",
        "isReadOnly": true
      }
    ],
    "capabilities": [
      {
        "slug": "<string>",
        "config": {}
      }
    ],
    "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>"
        ]
      }
    ],
    "output": {
      "type": "<string>"
    },
    "heartbeat": {
      "intervalMinutes": 123,
      "maxMessages": 123,
      "prompt": "<string>"
    },
    "evaluator": {
      "rubric": "<string>",
      "threshold": 0.5
    },
    "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[]

Actions 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<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})$
​
languageModelSlug
string

Language model identifier.

​
parentUuid
string<uuid>

Parent release 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})$
​
output
Output · object

Output format for the draft release. Pass null to inherit text output.

​
heartbeat
Heartbeat · object

Heartbeat configuration for chats created from this release. Pass null to disable.

​
evaluator
Evaluator · object

Evaluator configuration (rubric + quality threshold) used to grade agent output. Pass null to disable.

​
options
Options · object

Draft release options.

Response

Successful response

​
release
Release · object
required

Updated draft release details.