---
title: "Create agent"
method: POST
path: "/ai/agents"
tags: ["AI - Agents"]
---

# Create agent

`POST /ai/agents`

Create a new AI agent

## Request body

- object — Request body schema.
  - `name` string, required — Agent name.
  - `icon` object, required — Agent icon.
    - `color` 'grey' | 'green' | 'purple' | 'yellow' | 'blue' | 'red', required
    - `face` string, required
  - `description` string — Agent description.
  - `triggers` union[] — Agent triggers.
    - union
      - object
        - `name` string, required
        - `description` string, nullable, required
        - `type` 'cron', required
        - `cron` string, required
        - `text` string, required
      - object
        - `name` string, required
        - `description` string, nullable, required
        - `type` 'connector', required
        - `connectorUuid` string, nullable, required
        - `integrationSlug` string, required
        - `config` object, required
  - `folderUuid` string, uuid — Folder identifier for the agent.

## Response `200`

Successful response

- object
  - `agent` object, required — Created agent details.
    - `uuid` string, required
    - `workspaceUuid` string, required
    - `userUuid` string, nullable, required
    - `name` string, required
    - `icon` object, required
      - `color` 'grey' | 'green' | 'purple' | 'yellow' | 'blue' | 'red', required
      - `face` string, required
    - `description` string, nullable, required
    - `triggers` union[], required
      - union
        - object
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'cron', required
          - `cron` string, required
          - `text` string, required
          - `temporalScheduleWorkflowId` string, required
        - object
          - `name` string, required
          - `description` string, nullable, required
          - `type` 'connector', required
          - `connectorUuid` string, nullable, required
          - `integrationSlug` string, required
          - `config` object, required
    - `deployedRelease` object, nullable, required
      - `uuid` string, required
      - `userUuid` string, required
      - `description` string, nullable, required
      - `templateSlug` string, nullable, required
      - `version` string, nullable, required
      - `actions` union[], required
        - union
          - object
            - `name` string, nullable, required
            - `slug` string, required
            - `description` string, nullable, required
            - `isBulkAllowed` boolean, required
            - `config` object, required
            - `kind` 'tool', required
            - `toolUuid` string, nullable, required
            - `templateSlug` string, nullable, required
            - `waitUntilFinished` boolean, required
          - object
            - `name` string, nullable, required
            - `slug` string, required
            - `description` string, nullable, required
            - `isBulkAllowed` boolean, required
            - `config` object, required
            - `kind` 'agent', required
            - `agentUuid` string, nullable, required
            - `templateSlug` string, nullable, required
            - `waitUntilFinished` boolean, required
          - object
            - `name` string, nullable, required
            - `slug` string, required
            - `description` string, nullable, required
            - `isBulkAllowed` boolean, required
            - `config` object, required
            - `kind` 'connector', required
            - `integrationSlug` string, required
            - `connectorUuid` string, nullable, required
            - `actionSlug` string, required
      - `capabilities` union[], required
        - union
          - object
            - `slug` 'sandbox', required
            - `config` object, required
              - …
          - object
            - `slug` 'context', required
            - `config` object, required
              - …
          - object
            - `slug` 'app', required
            - `config` object, required
              - …
          - object
            - `slug` 'document', required
            - `config` object, required
          - object
            - `slug` 'webSearch', required
            - `config` object, required
          - object
            - `slug` 'fileSearch', required
            - `config` object, required
          - object
            - `slug` 'documentationSearch', required
            - `config` object, required
          - object
            - `slug` 'codeInterpreter', required
            - `config` object, required
          - object
            - `slug` 'memory', required
            - `config` object, required
          - object
            - `slug` 'suggestedActions', required
            - `config` object, required
      - `suggestedActions` object[], required
        - `text` string, required
        - `actions` object[], required
          - `slug` string, required
      - `systemPrompt` string, required
      - `withReasoning` boolean, required
      - `temperature` number, required
      - `maxSteps` number, required
      - `integrationSlug` string, required
      - `connectorUuid` string, nullable, required
      - `languageModelSlug` string, required
      - `mcpClients` union[], required
        - union
          - object
            - `kind` 'custom', required
            - `name` string, required
            - `url` string, required
            - `authentication` object, nullable, required
              - …
            - `disabledToolSlugs` string[], required
          - object
            - `kind` 'connector', required
            - `name` string, required
            - `connectorUuid` string, required
            - `integrationSlug` string, required
            - `disabledToolSlugs` string[], required
      - `resources` union[], required
        - union
          - object
            - `kind` 'model', required
            - `name` string, nullable, required
            - `slug` string, required
            - `description` string, nullable, required
            - `integrationSlug` string, nullable, required
            - `modelUuid` string, nullable, required
            - `filter` object, nullable, required
              - …
            - `selectedColumnSlugs` string[], nullable, required
            - `limit` number, nullable, required
            - `prompt` string, nullable, required
            - `isReadOnly` boolean, required
          - object
            - `kind` 'file', required
            - `name` string, nullable, required
            - `slug` string, required
            - `description` string, nullable, required
            - `items` union[], required
              - …
            - `prompt` string, nullable, required
      - `heartbeat` object, nullable, required
        - `intervalMinutes` integer, required
        - `maxMessages` integer, required
        - `prompt` string, nullable, required
      - `evaluator` object, nullable, required
        - `rubric` string, required
        - `threshold` number, required
      - `deployedAt` string, nullable, required
      - `createdAt` string, required
    - `folderUuid` string, nullable, required
    - `template` object, nullable, required
      - `slug` string, required
      - `isAvailable` boolean, required
      - `scope` 'public' | 'private', required
    - `isReadOnly` boolean, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/revisions/1d5a19e01d83/schema)