Action API

Action API

Version 2 is action-shaped: almost every operation is a POST to a named verb such as /createTask, returning an ok-discriminated envelope. That shape maps cleanly onto AI tool-calling, which is what it was designed for.

  • Status: Beta
  • Base URL: https://www.taskade.com/api/v2
  • Operations: 63
  • 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. If you need sustained throughput, prefer batching (operations like /createTask accept arrays) over tightening polling loops. 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/v2/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
List my projects POST /listMyProjects

Agents

Operation Method Path
Add knowledge media POST /addKnowledgeMedia
Add knowledge project POST /addKnowledgeProject
Create agent POST /createAgent
Delete agent POST /deleteAgent
Enable public agent access POST /enablePublicAgentAccess
Generate agent POST /generateAgent
Get agent POST /getAgent
Get conversation POST /getConversation
Get public agent POST /getPublicAgent
List agents POST /listAgents
List conversations POST /listConversations
Prompt agent POST /promptAgent
Remove knowledge media POST /removeKnowledgeMedia
Remove knowledge project POST /removeKnowledgeProject
Update agent POST /updateAgent
Update public agent POST /updatePublicAgent

Bundles

Operation Method Path
Export bundle POST /exportBundle
Import bundle POST /importBundle
Import bundle zip POST /importBundleZip
Zip GET /bundles/{spaceId}/export/zip

Media

Operation Method Path
Content GET /media/{mediaId}/content
Content GET /media/spaces/{spaceId}/content
Delete media POST /deleteMedia
Get media POST /getMedia
List media POST /listMedia
Upload media POST /uploadMedia

Projects

Operation Method Path
Complete project POST /completeProject
Copy project POST /copyProject
Create project POST /createProject
Create project from template POST /createProjectFromTemplate
Enable share link POST /enableShareLink
Get project POST /getProject
Get share link POST /getShareLink
List blocks POST /listBlocks
List fields POST /listFields
List project members POST /listProjectMembers
List projects POST /listProjects
List tasks POST /listTasks
Restore project POST /restoreProject

Tasks

Operation Method Path
Assign task POST /assignTask
Complete task POST /completeTask
Create task POST /createTask
Delete task POST /deleteTask
Delete task date POST /deleteTaskDate
Delete task field value POST /deleteTaskFieldValue
Delete task note POST /deleteTaskNote
Move task POST /moveTask
Set task date POST /setTaskDate
Set task field value POST /setTaskFieldValue
Set task note POST /setTaskNote
Unassign task POST /unassignTask
Uncomplete task POST /uncompleteTask
Update task POST /updateTask

Webhooks

Operation Method Path
Subscribe webhook POST /subscribeWebhook
Unsubscribe webhook POST /unsubscribeWebhook
Webhooks POST /webhooks
Webhooks GET /webhooks
Webhooks GET /webhooks/{id}
Webhooks DELETE /webhooks/{id}

Workspaces & folders

Operation Method Path
List folders POST /listFolders
List spaces POST /listSpaces
List templates POST /listTemplates

Account1

Agents16

Bundles4

Media6

Projects13

Tasks14

Webhooks6

Workspaces & folders3