Agents

get

Retrieves multiple agents.

Query parameters

joinsany ofOptionalDefault: []

string · enumOptionalPossible values:

pageNumbernumber · min: 1Optional

The page number.

Default: 1

pageSizenumber · min: 1 · max: 100Optional

The page size.

Default: 10

referenceIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

string · uuidOptional

A UUID v4 string that identifies an entity.

searchstring · min: 1Optional

Search term to filter agents by name, internal name, role, or prompt.

squadIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

string · uuidOptional

A UUID v4 string that identifies an entity.

versionIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

string · uuidOptional

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves all agents for the workspace.

application/json

401

Unauthorized.

application/json

get

/api/v1/agents

GET /api/v1/agents HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "createdAt": "2026-06-11T20:41:34.677Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isRemoved": true,
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T20:41:34.677Z",
    "versionId": "123e4567-e89b-12d3-a456-426614174000",
    "codeRuntime": true,
    "internalName": "text",
    "iterations": 1,
    "llm": "claude-haiku-4-5",
    "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "picture": "text",
    "planning": true,
    "prompt": "text",
    "reasoningMode": "low",
    "role": "text",
    "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
    "temperature": 1,
    "timezone": "Africa/Cairo",
    "toolCount": 1,
    "voiceId": "123e4567-e89b-12d3-a456-426614174000",
    "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
    "squadAgents": [
      {
        "createdAt": "2026-06-11T20:41:34.677Z",
        "updatedAt": "2026-06-11T20:41:34.677Z",
        "agentId": "123e4567-e89b-12d3-a456-426614174000",
        "squadId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "member",
        "squad": {
          "createdAt": "2026-06-11T20:41:34.677Z",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "isRemoved": true,
          "referenceId": "123e4567-e89b-12d3-a456-426614174000",
          "updatedAt": "2026-06-11T20:41:34.677Z",
          "versionId": "123e4567-e89b-12d3-a456-426614174000",
          "description": "text",
          "mode": "hierarchical",
          "name": "text",
          "picture": "text",
          "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
          "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
        }
      }
    ]
  }
]

post

Creates a new agent.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

codeRuntimebooleanRequired

Whether the agent should be able to execute JavaScript code using the Code Runtime tool.

internalNamestring · min: 3 · max: 50 · nullableRequired

The internal name of the agent. For internal use only.

iterationsnumber · min: 2 · max: 100Required

The number of iterations (steps) the agent can execute in a single execution.

llmstring · enumRequired

The LLM model key to use for the agent.

Possible values:

llmProviderIdstring · uuid · nullableRequired

The id of the LLM provider to use for the agent.

namestring · min: 3 · max: 50Required

The name of the agent.

picturestring · nullableRequired

The picture of the agent.

planningbooleanRequired

Whether the agent should plan before each execution.

promptstring · min: 1 · max: 10000Required

The main description of the agent's behavior.

reasoningModestring · enum · nullableRequired

The reasoning mode to use for the agent. If null, reasoning will be disabled.

Possible values:

rolestring · min: 1 · max: 250Required

The role of the agent. Particularly useful to give other agents context of what the agent does.

temperaturenumber · max: 2Required

The temperature to use for the agent. The lower the more deterministic. The higher the more creative.

timezonestring · enum · nullableRequired

The timezone to use for the agent. If null, no timezone will be used.

Possible values:

Responses

200

The agent was created.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

codeRuntimebooleanRequired

Whether the agent should be able to execute JavaScript code using the Code Runtime tool.

internalNamestring · min: 3 · max: 50 · nullableRequired

The internal name of the agent. For internal use only.

iterationsnumber · min: 2 · max: 100Required

The number of iterations (steps) the agent can execute in a single execution.

llmstring · enumRequired

The LLM model key to use for the agent.

Possible values:

llmProviderIdstring · uuid · nullableRequired

The id of the LLM provider to use for the agent.

namestring · min: 3 · max: 50Required

The name of the agent.

picturestring · nullableRequired

The picture of the agent.

planningbooleanRequired

Whether the agent should plan before each execution.

promptstring · min: 1 · max: 10000Required

The main description of the agent's behavior.

reasoningModestring · enum · nullableRequired

The reasoning mode to use for the agent. If null, reasoning will be disabled.

Possible values:

rolestring · min: 1 · max: 250Required

The role of the agent. Particularly useful to give other agents context of what the agent does.

superIdentityIdstring · uuidRequired

The super identity ID associated with the agent.

temperaturenumber · max: 2Required

The temperature to use for the agent. The lower the more deterministic. The higher the more creative.

timezonestring · enum · nullableRequired

The timezone to use for the agent. If null, no timezone will be used.

Possible values:

toolCountintegerRequired

The number of tools currently associated with the agent.

voiceIdstring · uuid · nullableRequired

The TTS voice to use for audio responses. Null when disabled for the agent.

workspaceIdstring · uuidRequired

The workspace ID that owns the agent.

401

Unauthorized.

application/json

403

Plan limit exceeded.

application/json

post

/api/v1/agents

POST /api/v1/agents HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 278

{
  "codeRuntime": true,
  "internalName": "text",
  "iterations": 1,
  "llm": "claude-haiku-4-5",
  "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "picture": "text",
  "planning": true,
  "prompt": "text",
  "reasoningMode": "low",
  "role": "text",
  "temperature": 1,
  "timezone": "Africa/Cairo"
}

{
  "createdAt": "2026-06-11T20:41:34.677Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T20:41:34.677Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "codeRuntime": true,
  "internalName": "text",
  "iterations": 1,
  "llm": "claude-haiku-4-5",
  "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "picture": "text",
  "planning": true,
  "prompt": "text",
  "reasoningMode": "low",
  "role": "text",
  "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
  "temperature": 1,
  "timezone": "Africa/Cairo",
  "toolCount": 1,
  "voiceId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}

post

Creates a new MCP or attaches an existing one to an agent.

Path parameters

agentIdstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

Responses

200

The MCP was created or linked to the agent.

application/json

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

agentIdstring · uuidRequired

The id of the agent to link the MCP to.

mcpIdstring · uuidRequired

The id of the MCP to link to the agent.

400

Connection type is not compatible with MCP type.

application/json

401

Unauthorized.

application/json

404

The agent, MCP, or connection was not found.

application/json

412

MCP is already associated with this agent.

application/json

post

/api/v1/agents/{agentId}/mcps

POST /api/v1/agents/{agentId}/mcps HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "mcp": {
    "connectionId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "detail": {
      "tools": [
        "text"
      ],
      "type": "composio-airtable"
    },
    "name": "text"
  }
}

{
  "createdAt": "2026-06-11T20:41:34.677Z",
  "updatedAt": "2026-06-11T20:41:34.677Z",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "mcpId": "123e4567-e89b-12d3-a456-426614174000",
  "mcp": {
    "createdAt": "2026-06-11T20:41:34.677Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isRemoved": true,
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T20:41:34.677Z",
    "versionId": "123e4567-e89b-12d3-a456-426614174000",
    "connectionId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "detail": {
      "tools": [
        "text"
      ],
      "type": "composio-airtable"
    },
    "name": "text",
    "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

post

Creates a new tool or attaches an existing one to an agent.

Path parameters

agentIdstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

Responses

200

The tool was created or linked to the agent.

application/json

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

agentIdstring · uuidRequired

The id of the agent to link the tool to.

toolIdstring · uuidRequired

The id of the tool to link to the agent.

400

Invalid tool configuration.

application/json

401

Unauthorized.

application/json

404

The agent or tool was not found.

application/json

post

/api/v1/agents/{agentId}/tools

POST /api/v1/agents/{agentId}/tools HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 219

{
  "tool": {
    "description": "text",
    "detail": {
      "allowedDomains": [
        "text"
      ],
      "effort": "low",
      "execution": "eligible",
      "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
      "prompt": "text",
      "type": "agentic-web-search"
    },
    "name": "text"
  }
}

{
  "createdAt": "2026-06-11T20:41:34.677Z",
  "updatedAt": "2026-06-11T20:41:34.677Z",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "toolId": "123e4567-e89b-12d3-a456-426614174000",
  "tool": {
    "createdAt": "2026-06-11T20:41:34.677Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isRemoved": true,
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T20:41:34.677Z",
    "versionId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "detail": {
      "allowedDomains": [
        "text"
      ],
      "effort": "low",
      "execution": "eligible",
      "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
      "prompt": "text",
      "type": "agentic-web-search"
    },
    "name": "text",
    "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

post

Executes an agent with provided messages.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

contextstringOptional

Responses

200

The agent was executed.

application/json

attachmentsUrlsstring[]Required

contentany ofRequired

stringOptional

401

Unauthorized.

application/json

404

Agent not found.

application/json

post

/api/v1/agents/{id}/execute

POST /api/v1/agents/{id}/execute HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 288

{
  "context": "text",
  "messages": [
    {
      "attachments": [
        {
          "base64": "text",
          "extension": "png"
        }
      ],
      "content": "text",
      "role": "assistant"
    }
  ],
  "output": {
    "properties": {
      "ANY_ADDITIONAL_PROPERTY": {
        "description": "text",
        "enum": [],
        "examples": [],
        "nullable": true,
        "type": "string"
      }
    },
    "required": [
      "text"
    ],
    "type": "object"
  }
}

{
  "attachmentsUrls": [
    "text"
  ],
  "content": "text",
  "execution": {
    "createdAt": "2026-06-11T20:41:34.677Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T20:41:34.677Z",
    "creditsUsed": 1,
    "detail": {
      "input": {
        "ANY_ADDITIONAL_PROPERTY": null
      },
      "output": {
        "ANY_ADDITIONAL_PROPERTY": null
      },
      "agentId": "text",
      "events": [
        {
          "creditsUsed": 1,
          "endedAt": "2026-06-11T20:41:34.677Z",
          "id": "text",
          "input": null,
          "label": "text",
          "output": {
            "ANY_ADDITIONAL_PROPERTY": null
          },
          "startedAt": "2026-06-11T20:41:34.677Z",
          "status": "running",
          "llm": "text",
          "llmProvider": {
            "id": "text",
            "name": "text"
          },
          "type": "iteration"
        }
      ],
      "origin": {
        "apiKeyId": "text",
        "type": "api"
      },
      "type": "agent-execution"
    },
    "endedAt": "2026-06-11T20:41:34.677Z",
    "isAgentic": true,
    "isPurged": true,
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "responderId": "text",
    "startedAt": "2026-06-11T20:41:34.677Z",
    "status": "running",
    "workspaceId": "text"
  }
}

get

Retrieves an agent.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves an agent.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

codeRuntimebooleanRequired

Whether the agent should be able to execute JavaScript code using the Code Runtime tool.

internalNamestring · min: 3 · max: 50 · nullableRequired

The internal name of the agent. For internal use only.

iterationsnumber · min: 2 · max: 100Required

The number of iterations (steps) the agent can execute in a single execution.

llmstring · enumRequired

The LLM model key to use for the agent.

Possible values:

llmProviderIdstring · uuid · nullableRequired

The id of the LLM provider to use for the agent.

namestring · min: 3 · max: 50Required

The name of the agent.

picturestring · nullableRequired

The picture of the agent.

planningbooleanRequired

Whether the agent should plan before each execution.

promptstring · min: 1 · max: 10000Required

The main description of the agent's behavior.

reasoningModestring · enum · nullableRequired

The reasoning mode to use for the agent. If null, reasoning will be disabled.

Possible values:

rolestring · min: 1 · max: 250Required

The role of the agent. Particularly useful to give other agents context of what the agent does.

superIdentityIdstring · uuidRequired

The super identity ID associated with the agent.

temperaturenumber · max: 2Required

The temperature to use for the agent. The lower the more deterministic. The higher the more creative.

timezonestring · enum · nullableRequired

The timezone to use for the agent. If null, no timezone will be used.

Possible values:

toolCountintegerRequired

The number of tools currently associated with the agent.

voiceIdstring · uuid · nullableRequired

The TTS voice to use for audio responses. Null when disabled for the agent.

workspaceIdstring · uuidRequired

The workspace ID that owns the agent.

401

Unauthorized.

application/json

404

Agent not found.

application/json

get

/api/v1/agents/{id}

GET /api/v1/agents/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "createdAt": "2026-06-11T20:41:34.677Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T20:41:34.677Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "codeRuntime": true,
  "internalName": "text",
  "iterations": 1,
  "llm": "claude-haiku-4-5",
  "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "picture": "text",
  "planning": true,
  "prompt": "text",
  "reasoningMode": "low",
  "role": "text",
  "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
  "temperature": 1,
  "timezone": "Africa/Cairo",
  "toolCount": 1,
  "voiceId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}

delete

Removes an agent.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The agent was removed.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

Agent not found.

application/json

412

Precondition failed.

application/json

delete

/api/v1/agents/{id}

DELETE /api/v1/agents/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

patch

Updates an agent.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

codeRuntimebooleanOptional

Whether the agent should be able to execute JavaScript code using the Code Runtime tool.

internalNamestring · min: 3 · max: 50 · nullableOptional

The internal name of the agent. For internal use only.

iterationsnumber · min: 2 · max: 100Optional

The number of iterations (steps) the agent can execute in a single execution.

llmstring · enumOptional

The LLM model key to use for the agent.

Possible values:

llmProviderIdstring · uuid · nullableOptional

The id of the LLM provider to use for the agent.

namestring · min: 3 · max: 50Optional

The name of the agent.

picturestring · nullableOptional

The picture of the agent.

planningbooleanOptional

Whether the agent should plan before each execution.

promptstring · min: 1 · max: 10000Optional

The main description of the agent's behavior.

reasoningModestring · enum · nullableOptional

The reasoning mode to use for the agent. If null, reasoning will be disabled.

Possible values:

rolestring · min: 1 · max: 250Optional

The role of the agent. Particularly useful to give other agents context of what the agent does.

superIdentityIdstring · uuidOptional

The super identity ID associated with the agent.

temperaturenumber · max: 2Optional

The temperature to use for the agent. The lower the more deterministic. The higher the more creative.

timezonestring · enum · nullableOptional

The timezone to use for the agent. If null, no timezone will be used.

Possible values:

toolCountintegerOptional

The number of tools currently associated with the agent.

voiceIdstring · uuid · nullableOptional

The TTS voice for audio responses. Null to disable.

Responses

200

The agent was updated.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

codeRuntimebooleanRequired

Whether the agent should be able to execute JavaScript code using the Code Runtime tool.

internalNamestring · min: 3 · max: 50 · nullableRequired

The internal name of the agent. For internal use only.

iterationsnumber · min: 2 · max: 100Required

The number of iterations (steps) the agent can execute in a single execution.

llmstring · enumRequired

The LLM model key to use for the agent.

Possible values:

llmProviderIdstring · uuid · nullableRequired

The id of the LLM provider to use for the agent.

namestring · min: 3 · max: 50Required

The name of the agent.

picturestring · nullableRequired

The picture of the agent.

planningbooleanRequired

Whether the agent should plan before each execution.

promptstring · min: 1 · max: 10000Required

The main description of the agent's behavior.

reasoningModestring · enum · nullableRequired

The reasoning mode to use for the agent. If null, reasoning will be disabled.

Possible values:

rolestring · min: 1 · max: 250Required

The role of the agent. Particularly useful to give other agents context of what the agent does.

superIdentityIdstring · uuidRequired

The super identity ID associated with the agent.

temperaturenumber · max: 2Required

The temperature to use for the agent. The lower the more deterministic. The higher the more creative.

timezonestring · enum · nullableRequired

The timezone to use for the agent. If null, no timezone will be used.

Possible values:

toolCountintegerRequired

The number of tools currently associated with the agent.

voiceIdstring · uuid · nullableRequired

The TTS voice to use for audio responses. Null when disabled for the agent.

workspaceIdstring · uuidRequired

The workspace ID that owns the agent.

401

Unauthorized.

application/json

404

Agent not found.

application/json

patch

/api/v1/agents/{id}

PATCH /api/v1/agents/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 398

{
  "codeRuntime": true,
  "internalName": "text",
  "iterations": 1,
  "llm": "claude-haiku-4-5",
  "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "picture": "text",
  "planning": true,
  "prompt": "text",
  "reasoningMode": "low",
  "role": "text",
  "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
  "temperature": 1,
  "timezone": "Africa/Cairo",
  "toolCount": 1,
  "voiceId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "createdAt": "2026-06-11T20:41:34.677Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T20:41:34.677Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "codeRuntime": true,
  "internalName": "text",
  "iterations": 1,
  "llm": "claude-haiku-4-5",
  "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "picture": "text",
  "planning": true,
  "prompt": "text",
  "reasoningMode": "low",
  "role": "text",
  "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
  "temperature": 1,
  "timezone": "Africa/Cairo",
  "toolCount": 1,
  "voiceId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}

delete

Detaches an MCP from an agent.

Path parameters

agentIdstring · uuidRequired

A UUID v4 string that identifies an entity.

mcpIdstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The MCP was removed from the agent.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

Agent or MCP not found.

application/json

delete

/api/v1/agents/{agentId}/mcps/{mcpId}

DELETE /api/v1/agents/{agentId}/mcps/{mcpId} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

delete

Detaches a tool from an agent.

Path parameters

agentIdstring · uuidRequired

A UUID v4 string that identifies an entity.

toolIdstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The tool was removed from the agent.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

Agent or tool not found.

application/json

delete

/api/v1/agents/{agentId}/tools/{toolId}

DELETE /api/v1/agents/{agentId}/tools/{toolId} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

PreviousDeveloper Platform API NextAnalytics

Last updated 1 hour ago