Agents

Summary of Endpoints

Update Agent Public Access

put

Enable public access in the agent

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Responses

200

Public access successfully enabled

application/json

4XX

Error description

application/json

put

HTTPcURLJavaScriptPython

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

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

Get Agent

get

Get agent with id

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Responses

200

Agent

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId} HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Responses

200

Agent successfully deleted

application/json

4XX

Error description

application/json

delete

HTTPcURLJavaScriptPython

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

{
  "ok": true
}

Update Agent

patch

Update agent

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Body

namestringOptional

Responses

200

Agent

application/json

4XX

Error description

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/v1/agents/{agentId} HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Responses

200

Public Agent

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId}/public-agent HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Body

Responses

200

Public Agent

application/json

4XX

Error description

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/v1/agents/{agentId}/public-agent HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Body

projectIdstringRequired

Responses

200

Project knowledge created

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/agents/{agentId}/knowledge/project HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Body

mediaIdstringRequired

Responses

200

Media knowledge created

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/agents/{agentId}/knowledge/media HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

projectIdstringRequired

Responses

200

Project knowledge removed

application/json

4XX

Error description

application/json

delete

HTTPcURLJavaScriptPython

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

{
  "ok": true
}

Remove Media from Agent Knowledge

delete

Remove a knowledge media

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

mediaIdstringRequired

Responses

200

Media knowledge removed

application/json

4XX

Error description

application/json

delete

HTTPcURLJavaScriptPython

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

{
  "ok": true
}

Get Agent Conversations

get

Get agent conversations

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Agent conversations

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/agents/{agentId}/convos/ HTTP/1.1
Host: www.taskade.com
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

oAuthAuthorizationCodepersonalAccessToken

Path parameters

agentIdstringRequired

convoIdstringRequired

Responses

200

Agent conversation

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

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

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