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
429response carriesx-rate-limit-limit,x-rate-limit-remaining, andx-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 |