REST API

REST API

Version 1 is the REST surface: resource-shaped paths and standard HTTP verbs. It is generally available and is the surface with the deepest task and project coverage.

  • Status: GA
  • Base URL: https://www.taskade.com/api/v1
  • Operations: 64
  • Rate limits: enforced per endpoint; ceilings are not published and can change without notice. A 429 response carries x-rate-limit-limit, x-rate-limit-remaining, and x-rate-limit-reset (seconds until the window reopens) — back off from those headers rather than hardcoding numbers. Bundle import/export runs under tighter limits than regular reads and writes, so schedule bulk transfers accordingly. See Rate limits.

Every page in this section is generated from the live OpenAPI document, so it cannot drift from the running service. The raw spec is at /api/documentation/v1/json.

You don't always need code for these: many of the same operations — creating projects and tasks, assigning, completing, moving, archiving — ship as native no-code actions in Automations, where triggers like Task Added or Schedule run them for you. Reach for the API when you're integrating an external system; reach for a flow when the whole loop lives inside Taskade.

Operations

Account

Operation Method Path
Me projects get GET /me/projects

Agents

Operation Method Path
Agent convo get GET /agents/{agentId}/convos/{convoId}
Agent convos get GET /agents/{agentId}/convos/
Agent get GET /agents/{agentId}
Agent knowledge media create POST /agents/{agentId}/knowledge/media
Agent knowledge media remove DELETE /agents/{agentId}/knowledge/media/{mediaId}
Agent knowledge project create POST /agents/{agentId}/knowledge/project
Agent knowledge project remove DELETE /agents/{agentId}/knowledge/project/{projectId}
Agent public access enable PUT /agents/{agentId}/publicAccess
Agent public get GET /agents/{agentId}/public-agent
Agent public update PATCH /agents/{agentId}/public-agent
Agent update PATCH /agents/{agentId}
Delete agent DELETE /agents/{agentId}
Public agent get GET /public-agents/{publicAgentId}

Bundles

Operation Method Path
Bundle export GET /bundles/{spaceId}/export
Bundle export zip GET /bundles/{spaceId}/export/zip
Bundle import POST /bundles/{workspaceId}/import
Bundle import zip POST /bundles/{workspaceId}/import/zip

Media

Operation Method Path
Media delete DELETE /medias/{mediaId}
Media download GET /medias/{mediaId}/download
Media download all GET /medias/spaces/{spaceId}/download
Media get GET /medias/{mediaId}
Media upload POST /medias/spaces/{spaceId}/upload

Projects

Operation Method Path
Project blocks get GET /projects/{projectId}/blocks
Project complete POST /projects/{projectId}/complete
Project copy POST /projects/{projectId}/copy
Project create POST /projects
Project fields get GET /projects/{projectId}/fields
Project from template POST /projects/from-template
Project get GET /projects/{projectId}
Project members get GET /projects/{projectId}/members
Project restore POST /projects/{projectId}/restore
Project share link enable PUT /projects/{projectId}/shareLink
Project share link get GET /projects/{projectId}/shareLink
Project tasks get GET /projects/{projectId}/tasks

Tasks

Operation Method Path
Task assignees get GET /projects/{projectId}/tasks/{taskId}/assignees
Task complete POST /projects/{projectId}/tasks/{taskId}/complete
Task create POST /projects/{projectId}/tasks/
Task delete DELETE /projects/{projectId}/tasks/{taskId}
Task delete assignees DELETE /projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}
Task delete date DELETE /projects/{projectId}/tasks/{taskId}/date
Task field value delete DELETE /projects/{projectId}/tasks/{taskId}/fields/{fieldId}
Task field value get GET /projects/{projectId}/tasks/{taskId}/fields/{fieldId}
Task field value put PUT /projects/{projectId}/tasks/{taskId}/fields/{fieldId}
Task fields value get GET /projects/{projectId}/tasks/{taskId}/fields
Task get GET /projects/{projectId}/tasks/{taskId}
Task get date GET /projects/{projectId}/tasks/{taskId}/date
Task move PUT /projects/{projectId}/tasks/{taskId}/move
Task note delete DELETE /projects/{projectId}/tasks/{taskId}/note
Task note get GET /projects/{projectId}/tasks/{taskId}/note
Task note put PUT /projects/{projectId}/tasks/{taskId}/note
Task put PUT /projects/{projectId}/tasks/{taskId}
Task put assignees PUT /projects/{projectId}/tasks/{taskId}/assignees
Task put date PUT /projects/{projectId}/tasks/{taskId}/date
Task uncomplete POST /projects/{projectId}/tasks/{taskId}/uncomplete

Workspaces & folders

Operation Method Path
Folder agent generate POST /folders/{folderId}/agent-generate
Folder agent get GET /folders/{folderId}/agents
Folder create agent POST /folders/{folderId}/agents
Folder project templates get GET /folders/{folderId}/project-templates
Folder projects get GET /folders/{folderId}/projects
Medias get GET /folders/{folderId}/medias
Workspace create project POST /workspaces/{workspaceId}/projects
Workspace folders get GET /workspaces/{workspaceId}/folders
Workspaces get GET /workspaces

Account1

Agents13

Bundles4

Media5

Projects12

Tasks20

Workspaces & folders9