Agents

The Intelligence Layer is the brain of your application. It's where reasoning, logic, and autonomous action take place. This layer is powered by Taskade's AI Agents.

An Agent is more than just a chatbot. It is an autonomous worker that can be configured with a specific personality, skillset, and access to knowledge. You can use Agents to:

• Power a Chatbot: Provide intelligent, context-aware answers to user queries based on the app's Knowledge Layer.

• Execute Complex Tasks: Trigger agents via automations to perform multi-step operations like analyzing data, qualifying leads, or summarizing documents.

• Collaborate with Humans: Assign tasks to agents and have them work alongside your team members within a project.

These endpoints allow you to create, manage, and interact with the AI Agents that bring your applications to life.

Learn More

• Custom AI Agents ›

• Tools for AI Agents ›

Summary of Endpoints

Update Agent Public Access

put

Enable public access in the agent

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Responses

200

Public access successfully enabled

application/json

Public access successfully enabled

okboolean · enumRequiredPossible values:

publicUrlstring · uriRequired

4XX

Error description

application/json

put

/agents/{agentId}/publicAccess

HTTPcURLJavaScriptPython

PUT /api/v1/agents/{agentId}/publicAccess HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "publicUrl": "https://example.com"
}

Get Agent

get

Get agent with id

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Responses

200

Agent

application/json

Agent

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get

/agents/{agentId}

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text"
    }
  }
}

Delete Agent

delete

Delete an agent

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Responses

200

Agent successfully deleted

application/json

Agent successfully deleted

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

delete

/agents/{agentId}

HTTPcURLJavaScriptPython

DELETE /api/v1/agents/{agentId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Update Agent

patch

Update agent

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Body

application/json

namestringOptional

Responses

200

Agent

application/json

Agent

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

patch

/agents/{agentId}

HTTPcURLJavaScriptPython

PATCH /api/v1/agents/{agentId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 234

{
  "name": "text",
  "data": {
    "commands": [
      {
        "name": "text",
        "prompt": "text",
        "id": "text",
        "mode": "default"
      }
    ],
    "description": "text",
    "tone": "authoritative",
    "avatar": {
      "type": "emoji",
      "data": {
        "value": "text"
      }
    },
    "knowledgeEnabled": true,
    "language": "text"
  }
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text"
    }
  }
}

Get Public Agent

get

Get public agent

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Responses

200

Public Agent

application/json

Public Agent

okboolean · enumRequiredPossible values:

publicUrlstring · uriRequired

4XX

Error description

application/json

get

/agents/{agentId}/public-agent

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId}/public-agent HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "space_agent_id": "text",
    "preferences": {
      "mode": "template",
      "canCopyKnowledge": true,
      "hideBranding": true,
      "theme": "light"
    }
  },
  "publicUrl": "https://example.com"
}

Update Public Agent

patch

Update public agent

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Body

application/json

Responses

200

Public Agent

application/json

Public Agent

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

patch

/agents/{agentId}/public-agent

HTTPcURLJavaScriptPython

PATCH /api/v1/agents/{agentId}/public-agent HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "preferences": {
    "mode": "template",
    "canCopyKnowledge": true,
    "hideBranding": true,
    "theme": "light"
  }
}

{
  "ok": true,
  "item": {
    "id": "text",
    "space_agent_id": "text",
    "preferences": {
      "mode": "template",
      "canCopyKnowledge": true,
      "hideBranding": true,
      "theme": "light"
    }
  }
}

Add Project to Agent Knowledge

post

Create a knowledge project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Body

application/json

projectIdstringRequired

Responses

200

Project knowledge created

application/json

Project knowledge created

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post

/agents/{agentId}/knowledge/project

HTTPcURLJavaScriptPython

POST /api/v1/agents/{agentId}/knowledge/project HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "projectId": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text"
    }
  }
}

Add Media to Agent Knowledge

post

Create a knowledge media

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Body

application/json

mediaIdstringRequired

Responses

200

Media knowledge created

application/json

Media knowledge created

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

post

/agents/{agentId}/knowledge/media

HTTPcURLJavaScriptPython

POST /api/v1/agents/{agentId}/knowledge/media HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "mediaId": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text",
    "space_id": "text",
    "data": {
      "commands": [
        {
          "name": "text",
          "prompt": "text",
          "id": "text",
          "mode": "default"
        }
      ],
      "description": "text",
      "tone": "authoritative",
      "avatar": {
        "type": "emoji",
        "data": {
          "value": "text"
        }
      },
      "knowledgeEnabled": true,
      "language": "text"
    }
  }
}

Remove Project from Agent Knowledge

delete

Remove a knowledge project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

projectIdstringRequired

Responses

200

Project knowledge removed

application/json

Project knowledge removed

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

delete

/agents/{agentId}/knowledge/project/{projectId}

HTTPcURLJavaScriptPython

DELETE /api/v1/agents/{agentId}/knowledge/project/{projectId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Remove Media from Agent Knowledge

delete

Remove a knowledge media

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

mediaIdstringRequired

Responses

200

Media knowledge removed

application/json

Media knowledge removed

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

delete

/agents/{agentId}/knowledge/media/{mediaId}

HTTPcURLJavaScriptPython

DELETE /api/v1/agents/{agentId}/knowledge/media/{mediaId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Get Agent Conversations

get

Get agent conversations

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Agent conversations

application/json

Agent conversations

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get

/agents/{agentId}/convos/

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId}/convos/ HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "space_agent_id": "text",
      "status": "in_progress",
      "title": "text",
      "data": {
        "llm": {
          "type": "openai",
          "name": "gpt-3.5-turbo"
        }
      }
    }
  ]
}

Get Specific Agent Conversation

get

Get agent conversation by id

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

convoIdstringRequired

Responses

200

Agent conversation

application/json

Agent conversation

okboolean · enumRequiredPossible values:

4XX

Error description

application/json

get

/agents/{agentId}/convos/{convoId}

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId}/convos/{convoId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "space_agent_id": "text",
    "status": "in_progress",
    "title": "text",
    "data": {
      "llm": {
        "type": "openai",
        "name": "gpt-3.5-turbo"
      }
    }
  }
}