From 1d1fa37014138a0a2f5fb817a938ed85ef86e664 Mon Sep 17 00:00:00 2001 From: johnxie Date: Tue, 9 Jun 2026 20:21:35 -0700 Subject: [PATCH 1/2] docs: ecosystem cross-links, SDK truth fixes, spec refresh, LICENSE Truth & safety: - 07_api.md: remove fabricated SDK trio (JS class that doesn't exist, Python example resolving to an unrelated third-party PyPI package, Go SDK whose repo 404s); replace with working HTTP-first examples (verified against the live v1 spec) + honest preview note for @taskade/sdk; fix wrong api.taskade.com host and fabricated POST /v1/tasks in the quickstart stepper - april-8 changelog: SDK 'yarn add' claim hedged to preview status - faq.md: custom domains 'Coming soon' -> live (shipped) - advanced-actions.md: speculative roadmap section replaced with present-tense AI automation building (EVE + Workflow Automation Mode) Cross-links (close the org link graph): - developer-home: Integration Kit row + mcp source link - automation/integrations: contribute footer -> taskade/integrations - developers/README: Integration Kit in SDKs & Tools - root README: Open Source bullet -> github.com/taskade Freshness & repo health: - .gitbook/assets/api-0.1.0.json refreshed from live spec (55->64 ops, verified strict superset at method level; all 110 {% openapi %} blocks still resolve); 3 orphaned spec duplicates deleted - changelog-2026 README: pointer to taskade.com/changelog for post-April - LICENSE: CC BY 4.0; .gitignore: exclude internal tracker files --- .gitbook/assets/api-0.1.0.json | 2 +- .gitbook/assets/json (1).json | 1437 ----------------- .gitbook/assets/json.json | 1 - .gitbook/assets/openapi taskade.json | 1 - .gitignore | 1 + LICENSE | 396 +++++ README.md | 1 + .../developer-home.md | 3 +- .../developers/README.md | 1 + .../automation/advanced-actions.md | 18 +- .../automation/integrations.md | 4 +- .../community-and-sharing/faq.md | 2 +- help-and-support/index/07_api.md | 49 +- updates-and-timeline/changelog-2026/README.md | 4 + .../changelog-2026/april-2026/april-8-2026.md | 2 +- 15 files changed, 444 insertions(+), 1478 deletions(-) delete mode 100644 .gitbook/assets/json (1).json delete mode 100644 .gitbook/assets/json.json delete mode 100644 .gitbook/assets/openapi taskade.json create mode 100644 LICENSE diff --git a/.gitbook/assets/api-0.1.0.json b/.gitbook/assets/api-0.1.0.json index 67a8dca..9c5a761 100644 --- a/.gitbook/assets/api-0.1.0.json +++ b/.gitbook/assets/api-0.1.0.json @@ -1 +1 @@ -{"openapi":"3.0.3","info":{"title":"Taskade Public API","description":"Taskade, the AI-Powered Productivity Platform.","version":"0.1.0"},"components":{"securitySchemes":{"oAuthAuthorizationCode":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.taskade.com/oauth2/authorize","tokenUrl":"https://www.taskade.com/oauth2/token","scopes":{}}}},"personalAccessToken":{"type":"http","scheme":"bearer"}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false},"ProjectShare":{"type":"object","properties":{"checkUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"},"viewUrl":{"type":"string","format":"uri"}},"required":["editUrl","viewUrl"],"additionalProperties":false,"description":"The share links of a project"},"ProjectTemplate":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"message":{"type":"string"},"code":{"type":"string"},"statusMessage":{"type":"string"}},"required":["ok","message","code","statusMessage"],"additionalProperties":false,"description":"Error description"},"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"text":{"type":"string"},"parentId":{"type":"string","format":"uuid"},"completed":{"type":"boolean","default":false}},"required":["id"],"additionalProperties":false},"TaskNote":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}},"required":["type","value"],"additionalProperties":false},"Date":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"time":{"type":"string","pattern":"^(?:[0-1][0-9]|[2][0-3]):[0-5][0-9](?::[0-5][0-9])?$","nullable":true},"timezone":{"type":"string","nullable":true}},"required":["date"],"additionalProperties":false},"SpaceAgent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"space_id":{"type":"string"},"data":{"type":"object","properties":{"commands":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Human-readable name of the command in title case. This should probably be a verb."},"prompt":{"type":"string","minLength":1,"description":"Tell the agent what this command will do. It should be positioned as a direct instruction to the agent. At least 30 words."},"id":{"type":"string","minLength":1,"description":"ID based on the name in snake case."},"mode":{"type":"string","enum":["default","plan-and-execute-v1","plan-and-execute-v2"],"default":"default"}},"required":["name","prompt","id"],"additionalProperties":false}},"description":{"type":"string","description":"Role and purpose of agent, positioned as a direct instruction to the agent. Example: \"You are a doctor that helps save lives.\". At least 100 words."},"tone":{"type":"string","enum":["authoritative","clinical","cold","confident","cynical","emotional","empathetic","formal","friendly","humourous","informal","ironic","optimistic","pessimistic","playful","sarcastic","serious","sympathetic","tentative","warm","creative","inspiring","casual"]},"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"data":{"type":"object","properties":{"value":{"type":"string","description":"Pick the most suitable emoji for this agent."}},"required":["value"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false}]},"knowledgeEnabled":{"type":"boolean"},"language":{"type":"string","description":"The language of the agent, e.g. en-US, zh-Hans"}},"required":["commands"],"additionalProperties":false}},"required":["id","name","space_id","data"],"additionalProperties":false},"Media":{"type":"object","properties":{"id":{"type":"string"},"space_id":{"type":"string"},"kind":{"type":"string"}},"required":["id","space_id","kind"],"additionalProperties":false},"User":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"}},"required":["handle"],"additionalProperties":false},"Field":{"type":"object","properties":{"id":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["boolean"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Note"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Timestamp"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string"},"description":{"type":"string"},"type":{"type":"string","enum":["Select"]},"options":{"type":"object","additionalProperties":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"rank":{"type":"string"},"description":{"type":"string"},"color":{"type":"string"}},"required":["id","name","rank"],"additionalProperties":false}},"defaultOption":{"type":"string"}},"required":["displayName","type","options"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"type":{"type":"string","enum":["number"]},"render":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["text"]}},"required":["type"],"additionalProperties":false}]},"format":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["decimal"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["currency"]},"config":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["standard"]},"code":{"type":"string","minLength":1}},"required":["type","code"],"additionalProperties":false}]}},"required":["type","config"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["unit"]},"config":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["standard"]},"unit":{"type":"string","minLength":1}},"required":["type","unit"],"additionalProperties":false}]}},"required":["type","config"],"additionalProperties":false}]}},"required":["displayName","type","render","format"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"type":{"type":"string","enum":["string"]},"description":{"type":"string"}},"required":["displayName","type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Assign"]},"title":{"type":"string"},"description":{"type":"string"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["DateTime"]},"title":{"type":"string"},"description":{"type":"string"},"format":{"type":"object","properties":{"time":{"type":"boolean"},"zone":{"anyOf":[{"type":"boolean"},{"type":"string"}]}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["DateRange"]},"title":{"type":"string"},"description":{"type":"string"},"format":{"type":"object","properties":{"time":{"type":"boolean"},"zone":{"anyOf":[{"type":"boolean"},{"type":"string"}]}},"additionalProperties":false}},"required":["type"],"additionalProperties":false}]}},"required":["id","data"],"additionalProperties":false},"FieldValue":{"type":"object","properties":{"fieldId":{"type":"string"},"value":{}},"required":["fieldId"],"additionalProperties":false},"Block":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"text":{"type":"string"},"completed":{"type":"boolean","default":false}},"required":["id"],"additionalProperties":false},"Convo":{"type":"object","properties":{"id":{"type":"string"},"space_agent_id":{"type":"string"},"status":{"type":"string","enum":["in_progress","idle","requires_review"]},"title":{"type":"string"},"data":{"type":"object","properties":{"llm":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"name":{"type":"string","enum":["gpt-3.5-turbo","gpt-4o","gpt-4-turbo","gpt-4o-mini"]}},"required":["type","name"],"additionalProperties":false}]}},"additionalProperties":false}},"required":["id","space_agent_id","status","data"],"additionalProperties":false}}},"paths":{"/workspaces/{workspaceId}/projects":{"post":{"operationId":"workspaceCreateProject","tags":["Workspace"],"description":"Create a project in a workspace","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["contentType","content"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces":{"get":{"operationId":"workspacesGet","tags":["Workspace"],"description":"Get all workspaces for a user","responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Workspaces"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces/{workspaceId}/folders":{"get":{"operationId":"workspaceFoldersGet","tags":["Workspace"],"description":"Get all folders for a workspace","parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Folders","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Folders"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}":{"get":{"operationId":"projectGet","tags":["Project"],"description":"Get project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/complete":{"post":{"operationId":"projectComplete","tags":["Project"],"description":"Mark the project as completed","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Completed project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Completed project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/restore":{"post":{"operationId":"projectRestore","tags":["Project"],"description":"Restore project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Restored project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Restored project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/copy":{"post":{"operationId":"projectCopy","tags":["Project"],"description":"Copy a project to a folder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"projectTitle":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Project Copied","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project Copied"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"post":{"operationId":"projectCreate","tags":["Project"],"description":"Create a project in a folder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["folderId","contentType","content"],"additionalProperties":false}}},"required":true},"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/from-template":{"post":{"operationId":"projectFromTemplate","tags":["Project"],"description":"Create a project from a custom template","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"templateId":{"type":"string","minLength":1}},"required":["folderId","templateId"],"additionalProperties":false}}},"required":true},"responses":{"200":{"description":"Successful Project creation from template","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation from template"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/members":{"get":{"operationId":"projectMembersGet","tags":["Project"],"description":"Get members of a project","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project members.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/User"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Project members."}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/fields":{"get":{"operationId":"projectFieldsGet","tags":["Project"],"description":"Get all fields for a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project fields","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Field"}}},"required":["ok","items"],"additionalProperties":false,"description":"Project fields"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/shareLink":{"get":{"operationId":"projectShareLinkGet","tags":["Project"],"description":"Get share link for the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/ProjectShare"}],"nullable":true,"description":"The share links of a project"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"projectShareLinkEnable","tags":["Project"],"description":"Enable share link in the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link successfully created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/blocks":{"get":{"operationId":"projectBlocksGet","tags":["Project"],"description":"Get all blocks for a project","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"after","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get blocks after it. Do not specify both before and after."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"before","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get blocks before it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Blocks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Block"}}},"required":["ok","items"],"additionalProperties":false,"description":"Blocks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks":{"get":{"operationId":"projectTasksGet","tags":["Project"],"description":"Get all tasks for a project","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"after","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"before","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Tasks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","items"],"additionalProperties":false,"description":"Tasks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}":{"get":{"operationId":"taskGet","tags":["Task"],"description":"Get task with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskDelete","tags":["Task"],"description":"Delete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Successful Task deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPut","tags":["Task"],"description":"Update task.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","pattern":"^[^\\r\\n]*$","maxLength":2000}},"required":["contentType","content"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Updated task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Updated task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/complete":{"post":{"operationId":"taskComplete","tags":["Task"],"description":"Complete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful complete a Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful complete a Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/uncomplete":{"post":{"operationId":"taskUncomplete","tags":["Task"],"description":"Mark a task as incomplete in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful mark the Task as incomplete","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful mark the Task as incomplete"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/":{"post":{"operationId":"taskCreate","tags":["Task"],"description":"Create a task in a project","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"allOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","maxLength":2000}},"required":["contentType","content"]},{"anyOf":[{"type":"object","properties":{"taskId":{"enum":["null"],"nullable":true},"placement":{"type":"string","enum":["afterbegin","beforeend"]}},"required":["placement"],"additionalProperties":false},{"type":"object","properties":{"taskId":{"type":"string"},"placement":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","placement"],"additionalProperties":false}]}]},"maxItems":20}},"required":["tasks"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Tasks creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Tasks creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/move":{"put":{"operationId":"taskMove","tags":["Task"],"description":"Move a task within the project","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"taskId":{"type":"string","minLength":1},"position":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","position"],"additionalProperties":false}},"required":["target"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful move Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful move Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees":{"get":{"operationId":"taskAssigneesGet","tags":["Task"],"description":"Get the assignees of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task assignees","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/User"}}},"required":["ok","items"],"additionalProperties":false,"description":"Task assignees"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutAssignees","tags":["Task"],"description":"Task assignment","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"array","items":{"type":"string","minLength":1}}},"required":["handles"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task assignment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task assignment"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}":{"delete":{"operationId":"taskDeleteAssignees","tags":["Task"],"description":"Remove assignee from a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"assigneeHandle","required":true}],"responses":{"200":{"description":"Successful Task Assignment deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Assignment deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/date":{"get":{"operationId":"taskGetDate","tags":["Task"],"description":"Get the date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task Date","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"anyOf":[{"$ref":"#/components/schemas/Date"},{"type":"object","properties":{"period":{"type":"string"}},"required":["period"],"additionalProperties":false}],"nullable":true}},"required":["start"],"additionalProperties":false}},"required":["ok","item"],"additionalProperties":false,"description":"Task Date"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskDeleteDate","tags":["Task"],"description":"Delete date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutDate","tags":["Task"],"description":"Create or update date for a task","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"$ref":"#/components/schemas/Date"}},"required":["start"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date create or update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date create or update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/note":{"get":{"operationId":"taskNoteGet","tags":["Task"],"description":"Get the note of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task Note","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/TaskNote"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task Note"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskNotePut","tags":["Task"],"description":"Add/update a note to the task","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["text/plain","text/markdown"]},"value":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"}},"required":["type","value"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Note creation/update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/TaskNote"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Note creation/update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskNoteDelete","tags":["Task"],"description":"Delete the note of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Note deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful Task Note deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/fields/{fieldId}":{"get":{"operationId":"taskFieldValueGet","tags":["Task"],"description":"Get the field value of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Task field value","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/FieldValue"}},"required":["ok","item"],"additionalProperties":false,"description":"Task field value"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskFieldValueDelete","tags":["Task"],"description":"Delete the field value of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Successful field value deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful field value deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskFieldValuePut","tags":["Task"],"description":"Update/create the field value of a task","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}]}},"required":["value"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Successful field value create/update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful field value create/update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/projects":{"get":{"operationId":"folderProjectsGet","tags":["Folder"],"description":"Get all projects in a folder, or in the home folder of a workspace.","parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true,"description":"Folder/Workspace/Space ID"}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/agent-generate":{"post":{"operationId":"folderAgentGenerate","tags":["Folder"],"description":"Generate agent based on input text prompts","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Default response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/agents":{"post":{"operationId":"folderCreateAgent","tags":["Folder"],"description":"Create an agent in a folder, or in the home folder of a workspace.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["data"]},"data":{"$ref":"#/components/schemas/SpaceAgent/properties/data"}},"required":["type","data"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["template"]},"template":{"type":"object","properties":{"type":{"type":"string","enum":["Tasker","Researcher","Marketer","EmailWriter","Sales","CustomerSupport","ProjectManager","ContentCreator","Copywriter","LegalAdvisor","SeoSpecialist","ProductivityCoach","EngineeringExpert","Translator","Summarizer","ResumeBuilder","Storyteller","Tutor","BrandStrategist","SocialMediaSpecialist","BusinessStrategist","FinancialAnalyst","HumanResourcesManager","DataScientist","ITConsultant","FinancialAdvisor","HealthCoach","SustainabilityConsultant","UXDesigner","QualityAssuranceAnalyst","ProductManager","GrowthHacker","BusinessDevelopmentManager","PublicRelationsSpecialist","EventPlanner","DataAnalyst","Editor","CEO","InterviewCoach","TechSupportAdvisor","Doctor","BlogExpert","TweetOptimizer","EmailMarketer","CourseCreator","ScriptCreator","ScreenplayWriter","Proofreader","SalesColdEmailCoach","CodeExplainer","CreativeWritingCoach","AdvertisingCopywriter","VideoScriptWriter","ProjectArchitect","AICouncil","Negotiator","VCAssociate","Books","StartupMentor","SmallBusiness","WebDevelopment","PromptEngineer","ArticleWriter","WorkflowAgent","StrategyAgent","ViralAgent","SOPOnboardingAgent","PressReleaseAgent"]},"avatar":{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar"}},"required":["type"],"additionalProperties":false}},"required":["type","template"],"additionalProperties":false}]}},"required":["name","data"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Default response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"folderAgentGet","tags":["Folder"],"description":"Get agents in a folder.","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Agents","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Agents"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/medias":{"get":{"operationId":"mediasGet","tags":["Folder"],"description":"Get medias in a folder","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Medias","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Media"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Medias"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/project-templates":{"get":{"operationId":"folderProjectTemplatesGet","tags":["Folder"],"description":"Get projects templates in a folder.","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Project Templates","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/ProjectTemplate"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Project Templates"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/projects":{"get":{"operationId":"meProjectsGet","tags":["Me"],"description":"Get all projects of mine","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string","enum":["viewed-asc","viewed-desc"],"default":"viewed-desc"},"in":"query","name":"sort","required":false}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/publicAccess":{"put":{"operationId":"agentPublicAccessEnable","tags":["Agent"],"description":"Enable public access in the agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public access successfully enabled","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","publicUrl"],"additionalProperties":false,"description":"Public access successfully enabled"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}":{"get":{"operationId":"agentGet","tags":["Agent"],"description":"Get agent with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteAgent","tags":["Agent"],"description":"Delete an agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent successfully deleted","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Agent successfully deleted"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"agentUpdate","tags":["Agent"],"description":"Update agent","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"data":{"$ref":"#/components/schemas/SpaceAgent/properties/data"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/public-agent":{"get":{"operationId":"agentPublicGet","tags":["Agent"],"description":"Get public agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"id":{"type":"string"},"space_agent_id":{"type":"string"},"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]}},"additionalProperties":false}},"required":["id","space_agent_id","preferences"],"additionalProperties":false},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","item","publicUrl"],"additionalProperties":false,"description":"Public Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"agentPublicUpdate","tags":["Agent"],"description":"Update public agent","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]}},"additionalProperties":false}},"required":["preferences"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"id":{"type":"string"},"space_agent_id":{"type":"string"},"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]}},"additionalProperties":false}},"required":["id","space_agent_id","preferences"],"additionalProperties":false}},"required":["ok","item"],"additionalProperties":false,"description":"Public Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/project":{"post":{"operationId":"agentKnowledgeProjectCreate","tags":["Agent"],"description":"Create a knowledge project","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string"}},"required":["projectId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Project knowledge created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false,"description":"Project knowledge created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/media":{"post":{"operationId":"agentKnowledgeMediaCreate","tags":["Agent"],"description":"Create a knowledge media","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string"}},"required":["mediaId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Media knowledge created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false,"description":"Media knowledge created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/project/{projectId}":{"delete":{"operationId":"agentKnowledgeProjectRemove","tags":["Agent"],"description":"Remove a knowledge project","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project knowledge removed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Project knowledge removed"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/media/{mediaId}":{"delete":{"operationId":"agentKnowledgeMediaRemove","tags":["Agent"],"description":"Remove a knowledge media","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Media knowledge removed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Media knowledge removed"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/convos/":{"get":{"operationId":"agentConvosGet","tags":["Agent"],"description":"Get agent conversations","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent conversations","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Convo"}}},"required":["ok","items"],"additionalProperties":false,"description":"Agent conversations"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/convos/{convoId}":{"get":{"operationId":"agentConvoGet","tags":["Agent"],"description":"Get agent conversation by id","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"convoId","required":true}],"responses":{"200":{"description":"Agent conversation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Convo"}},"required":["ok","item"],"additionalProperties":false,"description":"Agent conversation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/medias/{mediaId}":{"get":{"operationId":"mediaGet","tags":["Media"],"description":"Get media with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Media","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Media"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Media"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"mediaDelete","tags":["Media"],"description":"Delete a media","parameters":[{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Successful Media deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Successful Media deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"servers":[{"url":"https://www.taskade.com/api/v1","description":"Public API server"}],"security":[{"oAuthAuthorizationCode":[],"personalAccessToken":[]}]} \ No newline at end of file +{"openapi":"3.0.3","info":{"title":"Taskade Public API (v1)","description":"Taskade, the AI-Powered Productivity Platform.","version":"0.1.0"},"components":{"securitySchemes":{"oAuthAuthorizationCode":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.taskade.com/oauth2/authorize","tokenUrl":"https://www.taskade.com/oauth2/token","scopes":{}}}},"personalAccessToken":{"type":"http","scheme":"bearer"}},"schemas":{"BundleInstallation":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the bundle installation."},"projectCount":{"type":"number","description":"Number of projects installed."},"flowCount":{"type":"number","description":"Number of automations installed."},"agentCount":{"type":"number","description":"Number of agents installed."},"templateCount":{"type":"number","description":"Number of templates installed."},"mediaCount":{"type":"number","description":"Number of media files installed."},"appCount":{"type":"number","description":"Number of apps installed."}},"required":["id","projectCount","flowCount","agentCount","templateCount","mediaCount","appCount"],"additionalProperties":false},"Project":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the project. An alphanumeric string that is 16 characters long."},"name":{"type":"string","description":"The project’s name or title."}},"required":["id"],"additionalProperties":false},"ProjectShare":{"type":"object","properties":{"checkUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"},"viewUrl":{"type":"string","format":"uri"}},"required":["editUrl","viewUrl"],"additionalProperties":false,"description":"The share links of a project"},"ProjectTemplate":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"message":{"type":"string"},"code":{"type":"string"},"statusMessage":{"type":"string"}},"required":["ok","message","code","statusMessage"],"additionalProperties":false,"description":"Error description"},"Task":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"parentId":{"type":"string"},"completed":{"type":"boolean","default":false}},"required":["id"],"additionalProperties":false},"TaskNote":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"}},"required":["type","value"],"additionalProperties":false},"Date":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO date format (YYYY-MM-DD), e.g. \"2021-12-31\""},"time":{"type":"string","pattern":"^(?:[0-1][0-9]|[2][0-3]):[0-5][0-9](?::[0-5][0-9])?$","nullable":true,"description":"Optional time component in 24-hour format (HH:MM:SS), e.g. \"15:30:45\". Can be null or omitted for date-only representations"},"timezone":{"type":"string","nullable":true,"description":"Optional timezone identifier (IANA timezone name), e.g. \"America/New_York\", \"Asia/Singapore\". Can be null or omitted for timezone-naive representations"}},"required":["date"],"additionalProperties":false},"SpaceAgent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"space_id":{"type":"string"},"data":{"type":"object","properties":{"commands":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Human-readable name of the command in title case. This should probably be a verb."},"description":{"type":"string","nullable":true,"description":"Short summary for discovery (e.g. progressive disclosure / skill listing). The full instruction stays in `prompt`."},"prompt":{"type":"string","minLength":1,"description":"Tell the agent what this command will do. It should be positioned as a direct instruction to the agent. At least 30 words."},"id":{"type":"string","minLength":1,"description":"ID based on the name in snake case."},"mode":{"type":"string","enum":["default","plan-and-execute-v1","plan-and-execute-v2"],"default":"default"}},"required":["name","prompt","id"],"additionalProperties":false}},"description":{"type":"string","description":"Role and purpose of agent, positioned as a direct instruction to the agent. Example: \"You are a doctor that helps save lives.\". At least 100 words."},"tone":{"type":"string","enum":["authoritative","clinical","cold","confident","cynical","emotional","empathetic","formal","friendly","humourous","informal","ironic","optimistic","pessimistic","playful","sarcastic","serious","sympathetic","tentative","warm","creative","inspiring","casual"]},"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"data":{"type":"object","properties":{"value":{"type":"string","description":"Pick the most suitable emoji for this agent."}},"required":["value"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false}]},"knowledgeEnabled":{"type":"boolean"},"language":{"type":"string","description":"The language of the agent, e.g. en-US, zh-Hans"},"inputPlaceholder":{"type":"string","nullable":true}},"required":["commands"],"additionalProperties":false}},"required":["id","name","space_id","data"],"additionalProperties":false},"Media":{"type":"object","properties":{"id":{"type":"string"},"space_id":{"type":"string"},"kind":{"type":"string"}},"required":["id","space_id","kind"],"additionalProperties":false},"User":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"}},"required":["handle"],"additionalProperties":false},"Field":{"type":"object","properties":{"id":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["boolean"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Note"]},"fillerConfig":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["string.translate"]},"sourceRef":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["field"]},"fieldPath":{"type":"string"}},"required":["type","fieldPath"],"additionalProperties":false}]},"targetLang":{"type":"string"}},"required":["type","sourceRef","targetLang"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["string.summarize"]},"sourceRef":{"$ref":"#/properties/data/anyOf/1/properties/fillerConfig/anyOf/0/properties/sourceRef"},"additionalInstructions":{"type":"string"}},"required":["type","sourceRef"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["string.extract"]},"sourceRef":{"$ref":"#/properties/data/anyOf/1/properties/fillerConfig/anyOf/0/properties/sourceRef"},"entity":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email_address"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["first_name"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["last_name"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["phone_number"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["domain_name"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["link"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["date"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["time"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["year"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"instructions":{"type":"string"}},"required":["type","instructions"],"additionalProperties":false}]}},"required":["type","sourceRef","entity"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["string.custom"]},"instructions":{"type":"string"}},"required":["type","instructions"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Select.pick"]},"sourceRef":{"$ref":"#/properties/data/anyOf/1/properties/fillerConfig/anyOf/0/properties/sourceRef"},"permittedOptionIds":{"type":"array","items":{"type":"string"}},"additionalInstructions":{"type":"string"}},"required":["type","sourceRef","permittedOptionIds"],"additionalProperties":false}]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Timestamp"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["TimestampAt"]},"displayName":{"type":"string"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["TimestampAuthor"]},"displayName":{"type":"string"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string"},"description":{"type":"string"},"type":{"type":"string","enum":["Select"]},"options":{"type":"object","additionalProperties":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"rank":{"type":"string"},"description":{"type":"string"},"color":{"type":"string"}},"required":["id","name","rank"],"additionalProperties":false}},"defaultOption":{"type":"string"},"fillerConfig":{"$ref":"#/properties/data/anyOf/1/properties/fillerConfig"}},"required":["displayName","type","options"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"type":{"type":"string","enum":["number"]},"render":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["text"]}},"required":["type"],"additionalProperties":false}]},"format":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["decimal"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["currency"]},"config":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["standard"]},"code":{"type":"string","minLength":1}},"required":["type","code"],"additionalProperties":false}]}},"required":["type","config"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["unit"]},"config":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["standard"]},"unit":{"type":"string","minLength":1}},"required":["type","unit"],"additionalProperties":false}]}},"required":["type","config"],"additionalProperties":false}]}},"required":["displayName","type","render","format"],"additionalProperties":false},{"type":"object","properties":{"displayName":{"type":"string","minLength":1},"type":{"type":"string","enum":["string"]},"description":{"type":"string"},"fillerConfig":{"$ref":"#/properties/data/anyOf/1/properties/fillerConfig"},"constraints":{"type":"object","properties":{"unique":{"type":"object","properties":{"type":{"type":"string","enum":["unique"]}},"required":["type"],"additionalProperties":false}},"additionalProperties":false}},"required":["displayName","type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Password"]},"title":{"type":"string"},"description":{"type":"string"},"hashAlgorithm":{"type":"string","enum":["bcrypt","argon2","scrypt","pbkdf2"],"default":"bcrypt"},"minLength":{"type":"integer","minimum":1,"default":8},"maxLength":{"type":"integer","minimum":1}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Assign"]},"title":{"type":"string"},"description":{"type":"string"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["DateTime"]},"title":{"type":"string"},"description":{"type":"string"},"format":{"type":"object","properties":{"time":{"type":"boolean"},"zone":{"anyOf":[{"type":"boolean"},{"type":"string"}]}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["DateRange"]},"title":{"type":"string"},"description":{"type":"string"},"format":{"type":"object","properties":{"time":{"type":"boolean"},"zone":{"anyOf":[{"type":"boolean"},{"type":"string"}]}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["NodeText"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["NodeCompleted"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["Unimplemented"]}},"required":["type"],"additionalProperties":false}]}},"required":["id","data"],"additionalProperties":false},"FieldValue":{"type":"object","properties":{"fieldId":{"type":"string"},"value":{}},"required":["fieldId"],"additionalProperties":false},"Block":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"completed":{"type":"boolean","default":false}},"required":["id"],"additionalProperties":false},"Convo":{"type":"object","properties":{"id":{"type":"string"},"space_agent_id":{"type":"string"},"status":{"type":"string","enum":["in_progress","idle","requires_review"]},"title":{"type":"string"},"data":{"type":"object","properties":{"llm":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"name":{"type":"string","enum":["gpt-3.5-turbo","gpt-4o","gpt-4-turbo","gpt-4o-mini","gpt-4.1","gpt-4.1-mini","gpt-4.1-nano","o3-mini:low","o3-mini:medium","o3-mini:high","o4-mini:low","o4-mini:medium","o4-mini:high","openai/gpt-4o","openai/gpt-4o-mini","openai/gpt-4.1","openai/gpt-4.1-mini","openai/gpt-4.1-nano","openai/gpt-5","openai/gpt-5:high","openai/gpt-5-mini","openai/gpt-5-mini:high","openai/gpt-5-nano","openai/gpt-5-nano:high","openai/gpt-5.1","openai/gpt-5.1:low","openai/gpt-5.1:medium","openai/gpt-5.1:high","openai/gpt-5.1-codex","openai/gpt-5.1-codex:low","openai/gpt-5.1-codex:medium","openai/gpt-5.1-codex:high","openai/gpt-5.1-codex-max","openai/gpt-5.1-codex-max:medium","openai/gpt-5.1-codex-max:high","openai/gpt-5.1-codex-max:xhigh","openai/gpt-5.2","openai/gpt-5.2:medium","openai/gpt-5.2:high","openai/gpt-5.2:xhigh","openai/gpt-5.2-codex","openai/gpt-5.2-codex:medium","openai/gpt-5.2-codex:high","openai/gpt-5.2-codex:xhigh","openai/gpt-5.3-codex","openai/gpt-5.3-codex:medium","openai/gpt-5.3-codex:high","openai/gpt-5.3-codex:xhigh","openai/gpt-5.3-chat","openai/gpt-5.4","openai/gpt-5.4:medium","openai/gpt-5.4:high","openai/gpt-5.4:xhigh","openai/gpt-5.4-pro","openai/gpt-5.4-pro:medium","openai/gpt-5.4-pro:high","openai/gpt-5.4-pro:xhigh","openai/gpt-5.4-mini","openai/gpt-5.4-nano","openai/gpt-5.5","openai/gpt-5.5:medium","openai/gpt-5.5:high","openai/gpt-5.5:xhigh","openai/gpt-5.5-pro","openai/gpt-5.5-pro:medium","openai/gpt-5.5-pro:high","openai/gpt-5.5-pro:xhigh"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["anthropic"]},"name":{"type":"string","enum":["anthropic/claude-4.0-sonnet","anthropic/claude-4.0-opus","anthropic/claude-sonnet-4.5","anthropic/claude-sonnet-4.5:thinking","anthropic/claude-haiku-4.5","anthropic/claude-haiku-4.5:thinking","anthropic/claude-opus-4.5","anthropic/claude-opus-4.5:thinking","anthropic/claude-opus-4.8","anthropic/claude-opus-4.8:thinking","anthropic/claude-opus-4.7","anthropic/claude-opus-4.7:thinking","anthropic/claude-opus-4.6","anthropic/claude-opus-4.6:thinking","anthropic/claude-sonnet-4.6","anthropic/claude-sonnet-4.6:thinking","anthropic/claude-3.5-sonnet","anthropic/claude-3.5-haiku","anthropic/claude-3.7-sonnet"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["google"]},"name":{"type":"string","enum":["google/gemini-2.5-pro","google/gemini-2.5-flash","google/gemini-2.5-flash-lite","google/gemini-3-pro-preview","google/gemini-3-flash-preview","google/gemini-3.1-pro-preview","google/gemini-3.1-flash-lite-preview","google/gemini-3.1-flash-lite","google/gemini-3.5-flash","google/gemma-4-31b-it","google/gemma-4-26b-a4b-it"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["alibaba"]},"name":{"type":"string","enum":["alibaba/qwen3.7-plus","alibaba/qwen3.6-plus","alibaba/qwen3.6-27b","alibaba/qwen-3.6-max-preview","alibaba/qwen3.7-max"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["minimax"]},"name":{"type":"string","enum":["minimax/minimax-m3","minimax/minimax-m2.7"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["zai"]},"name":{"type":"string","enum":["zai/glm-5.1"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["moonshotai"]},"name":{"type":"string","enum":["moonshotai/kimi-k2.6"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["deepseek"]},"name":{"type":"string","enum":["deepseek/deepseek-v4-pro","deepseek/deepseek-v4-flash"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["xai"]},"name":{"type":"string","enum":["xai/grok-4.3","xai/grok-build-0.1"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["xiaomi"]},"name":{"type":"string","enum":["xiaomi/mimo-v2.5","xiaomi/mimo-v2.5-pro"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["nvidia"]},"name":{"type":"string","enum":["nvidia/nemotron-3-ultra-550b-a55b"]}},"required":["type","name"],"additionalProperties":false}]},"endedAt":{"type":"number"}},"additionalProperties":false}},"required":["id","space_agent_id","status","data"],"additionalProperties":false}}},"paths":{"/workspaces/{workspaceId}/projects":{"post":{"operationId":"workspaceCreateProject","tags":["Workspace"],"description":"Create a project in a workspace","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["contentType","content"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces":{"get":{"operationId":"workspacesGet","tags":["Workspace"],"description":"Get all workspaces for a user","responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the workspace or folder. An alphanumeric string that is either 16 characters long or 9 characters long (the 9-character version may include underscores or hyphens)"},"name":{"type":"string","description":"Name of the workspace or folder."}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Workspaces"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces/{workspaceId}/folders":{"get":{"operationId":"workspaceFoldersGet","tags":["Workspace"],"description":"Get all folders for a workspace","parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Folders","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the workspace or folder. An alphanumeric string that is either 16 characters long or 9 characters long (the 9-character version may include underscores or hyphens)"},"name":{"type":"string","description":"Name of the workspace or folder."}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Folders"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}":{"get":{"operationId":"projectGet","tags":["Project"],"description":"Get project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/complete":{"post":{"operationId":"projectComplete","tags":["Project"],"description":"Mark the project as completed","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Completed project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Completed project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/restore":{"post":{"operationId":"projectRestore","tags":["Project"],"description":"Restore project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Restored project","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Restored project"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/copy":{"post":{"operationId":"projectCopy","tags":["Project"],"description":"Copy a project to a folder","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"projectTitle":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Project Copied","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project Copied"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"post":{"operationId":"projectCreate","tags":["Project"],"description":"Create a project in a team","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["folderId","contentType","content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/from-template":{"post":{"operationId":"projectFromTemplate","tags":["Project"],"description":"Create a project from a custom template","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"templateId":{"type":"string","minLength":1}},"required":["folderId","templateId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful Project creation from template","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation from template"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/members":{"get":{"operationId":"projectMembersGet","tags":["Project"],"description":"Get members of a project","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project members.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/User"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Project members."}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/fields":{"get":{"operationId":"projectFieldsGet","tags":["Project"],"description":"Get all fields for a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project fields","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Field"}}},"required":["ok","items"],"additionalProperties":false,"description":"Project fields"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/shareLink":{"get":{"operationId":"projectShareLinkGet","tags":["Project"],"description":"Get share link for the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/ProjectShare"}],"nullable":true,"description":"The share links of a project"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"projectShareLinkEnable","tags":["Project"],"description":"Enable share link in the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link successfully created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/blocks":{"get":{"operationId":"projectBlocksGet","tags":["Project"],"description":"Get all blocks for a project","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Parameter for cursor-based pagination. Specify block ID to get blocks after it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"query","name":"before","required":false,"description":"Parameter for cursor-based pagination. Specify block ID to get blocks before it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Blocks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Block"}}},"required":["ok","items"],"additionalProperties":false,"description":"Blocks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks":{"get":{"operationId":"projectTasksGet","tags":["Project"],"description":"Get all tasks for a project","parameters":[{"schema":{"type":"number","maximum":1000,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"query","name":"before","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Tasks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","items"],"additionalProperties":false,"description":"Tasks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}":{"get":{"operationId":"taskGet","tags":["Task"],"description":"Get task with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskDelete","tags":["Task"],"description":"Delete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Successful Task deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPut","tags":["Task"],"description":"Update task.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","pattern":"^[^\\r\\n]*$","maxLength":2000}},"required":["contentType","content"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Updated task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Updated task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/complete":{"post":{"operationId":"taskComplete","tags":["Task"],"description":"Complete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful complete a Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful complete a Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/uncomplete":{"post":{"operationId":"taskUncomplete","tags":["Task"],"description":"Mark a task as incomplete in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful mark the Task as incomplete","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful mark the Task as incomplete"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/":{"post":{"operationId":"taskCreate","tags":["Task"],"description":"Create one or more tasks in a project","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"allOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","maxLength":2000}},"required":["contentType","content"]},{"anyOf":[{"type":"object","properties":{"taskId":{"enum":["null"],"nullable":true},"placement":{"type":"string","enum":["afterbegin","beforeend"]}},"required":["placement"],"additionalProperties":false},{"type":"object","properties":{"taskId":{"type":"string"},"placement":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","placement"],"additionalProperties":false}]}]},"maxItems":20}},"required":["tasks"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true,"description":"Unique identifier for the project."}],"responses":{"200":{"description":"Successful Tasks creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Tasks creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/move":{"put":{"operationId":"taskMove","tags":["Task"],"description":"Move a task within the project","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"taskId":{"type":"string","minLength":1},"position":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","position"],"additionalProperties":false}},"required":["target"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful move Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful move Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees":{"get":{"operationId":"taskAssigneesGet","tags":["Task"],"description":"Get the assignees of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task assignees","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/User"}}},"required":["ok","items"],"additionalProperties":false,"description":"Task assignees"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutAssignees","tags":["Task"],"description":"Task assignment","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"array","items":{"type":"string","minLength":1}}},"required":["handles"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task assignment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task assignment"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}":{"delete":{"operationId":"taskDeleteAssignees","tags":["Task"],"description":"Remove assignee from a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"assigneeHandle","required":true}],"responses":{"200":{"description":"Successful Task Assignment deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Assignment deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/date":{"get":{"operationId":"taskGetDate","tags":["Task"],"description":"Get the date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task Date","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"anyOf":[{"$ref":"#/components/schemas/Date"},{"type":"object","properties":{"period":{"type":"string"}},"required":["period"],"additionalProperties":false}],"nullable":true}},"required":["start"],"additionalProperties":false}},"required":["ok","item"],"additionalProperties":false,"description":"Task Date"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskDeleteDate","tags":["Task"],"description":"Delete date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutDate","tags":["Task"],"description":"Create or update date for a task","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"$ref":"#/components/schemas/Date"}},"required":["start"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date create or update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Task"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date create or update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/note":{"get":{"operationId":"taskNoteGet","tags":["Task"],"description":"Get the note of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task Note","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/TaskNote"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task Note"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskNotePut","tags":["Task"],"description":"Add/update a note to the task","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["text/plain","text/markdown"]},"value":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"}},"required":["type","value"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Note creation/update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"allOf":[{"$ref":"#/components/schemas/TaskNote"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Note creation/update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskNoteDelete","tags":["Task"],"description":"Delete the note of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Note deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful Task Note deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/fields":{"get":{"operationId":"taskFieldsValueGet","tags":["Task"],"description":"Get all field values for a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task field values","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/FieldValue"}}},"required":["ok","items"],"additionalProperties":false,"description":"Task field values"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/fields/{fieldId}":{"get":{"operationId":"taskFieldValueGet","tags":["Task"],"description":"Get the field value of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Task field value","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/FieldValue"}},"required":["ok","item"],"additionalProperties":false,"description":"Task field value"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"taskFieldValueDelete","tags":["Task"],"description":"Delete the field value of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Successful field value deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful field value deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskFieldValuePut","tags":["Task"],"description":"Update/create the field value of a task","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}]}},"required":["value"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"fieldId","required":true}],"responses":{"200":{"description":"Successful field value create/update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false,"description":"Successful field value create/update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/projects":{"get":{"operationId":"folderProjectsGet","tags":["Folder"],"description":"Get all projects in a team, or in the home team of a workspace.","parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true,"description":"Folder/Workspace/Space ID"}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Project"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/agent-generate":{"post":{"operationId":"folderAgentGenerate","tags":["Folder"],"description":"Generate agent based on input text prompts","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Default response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/agents":{"post":{"operationId":"folderCreateAgent","tags":["Folder"],"description":"Create an agent in a team or workspace.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["data"]},"data":{"$ref":"#/components/schemas/SpaceAgent/properties/data"}},"required":["type","data"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["template"]},"template":{"type":"object","properties":{"type":{"type":"string","enum":["Tasker","Researcher","Marketer","EmailWriter","Sales","CustomerSupport","ProjectManager","ContentCreator","Copywriter","LegalAdvisor","SeoSpecialist","ProductivityCoach","EngineeringExpert","Translator","Summarizer","ResumeBuilder","Storyteller","Tutor","BrandStrategist","SocialMediaSpecialist","BusinessStrategist","FinancialAnalyst","HumanResourcesManager","DataScientist","ITConsultant","FinancialAdvisor","HealthCoach","SustainabilityConsultant","UXDesigner","QualityAssuranceAnalyst","ProductManager","GrowthHacker","BusinessDevelopmentManager","PublicRelationsSpecialist","EventPlanner","DataAnalyst","Editor","CEO","InterviewCoach","TechSupportAdvisor","Doctor","BlogExpert","TweetOptimizer","EmailMarketer","CourseCreator","ScriptCreator","ScreenplayWriter","Proofreader","SalesColdEmailCoach","CodeExplainer","CreativeWritingCoach","AdvertisingCopywriter","VideoScriptWriter","ProjectArchitect","AICouncil","Negotiator","VCAssociate","Books","StartupMentor","SmallBusiness","WebDevelopment","PromptEngineer","ArticleWriter","WorkflowAgent","StrategyAgent","ViralAgent","SOPOnboardingAgent","PressReleaseAgent"]},"avatar":{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar"}},"required":["type"],"additionalProperties":false}},"required":["type","template"],"additionalProperties":false}]}},"required":["name","data"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Default response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"folderAgentGet","tags":["Folder"],"description":"Get agents in a folder.","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Agents","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Agents"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/medias":{"get":{"operationId":"mediasGet","tags":["Folder"],"description":"Get medias in a folder","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Medias","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Media"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Medias"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/project-templates":{"get":{"operationId":"folderProjectTemplatesGet","tags":["Folder"],"description":"Get projects templates in a folder.","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Project Templates","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/ProjectTemplate"}],"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Project Templates"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/projects":{"get":{"operationId":"meProjectsGet","tags":["Me"],"description":"Get all projects of mine","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string","enum":["viewed-asc","viewed-desc"],"default":"viewed-desc"},"in":"query","name":"sort","required":false}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/publicAccess":{"put":{"operationId":"agentPublicAccessEnable","tags":["Agent"],"description":"Enable public access in the agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public access successfully enabled","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","publicUrl"],"additionalProperties":false,"description":"Public access successfully enabled"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}":{"get":{"operationId":"agentGet","tags":["Agent"],"description":"Get agent with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteAgent","tags":["Agent"],"description":"Delete an agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent successfully deleted","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Agent successfully deleted"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"agentUpdate","tags":["Agent"],"description":"Update agent","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"data":{"$ref":"#/components/schemas/SpaceAgent/properties/data"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/SpaceAgent"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/public-agent":{"get":{"operationId":"agentPublicGet","tags":["Agent"],"description":"Get public agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"data":{"type":"object","properties":{"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"data":{"type":"object","properties":{"file":{"type":"object","properties":{"ownerID":{"type":"string"},"ownerType":{"type":"string","minLength":1,"nullable":true},"id":{"type":"string"},"namespace":{"type":"string"},"extension":{"type":"string"},"s3KeyOriginal":{"type":"string"},"userID":{"type":"number","nullable":true},"spaceID":{"type":"string","minLength":1,"nullable":true},"documentID":{"type":"string","minLength":1,"nullable":true},"nodeID":{"type":"string","minLength":1,"nullable":true},"size":{"type":"number"},"mimetype":{"type":"string"},"metadata":{"type":"object","properties":{},"additionalProperties":true},"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["ownerID","id","namespace","extension","s3KeyOriginal","size","mimetype"],"additionalProperties":true}},"required":["file"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false},{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar/anyOf/0"}]},"conversationStarters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"prompt":{"type":"string"}},"required":["id","text"],"additionalProperties":false}}},"additionalProperties":false},"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]},"autoEndChats":{"type":"boolean"},"meta":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"image":{"allOf":[{"$ref":"#/properties/item/properties/data/properties/avatar/anyOf/0/properties/data/properties/file"}],"nullable":true}},"additionalProperties":false}},"additionalProperties":false}},"required":["id","name","data","preferences"],"additionalProperties":false},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","item","publicUrl"],"additionalProperties":false,"description":"Public Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"agentPublicUpdate","tags":["Agent"],"description":"Update public agent","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]},"autoEndChats":{"type":"boolean"},"meta":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"image":{"type":"object","properties":{"ownerID":{"type":"string"},"ownerType":{"type":"string","minLength":1,"nullable":true},"id":{"type":"string"},"namespace":{"type":"string"},"extension":{"type":"string"},"s3KeyOriginal":{"type":"string"},"userID":{"type":"number","nullable":true},"spaceID":{"type":"string","minLength":1,"nullable":true},"documentID":{"type":"string","minLength":1,"nullable":true},"nodeID":{"type":"string","minLength":1,"nullable":true},"size":{"type":"number"},"mimetype":{"type":"string"},"metadata":{"type":"object","properties":{},"additionalProperties":true},"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["ownerID","id","namespace","extension","s3KeyOriginal","size","mimetype"],"additionalProperties":true,"nullable":true}},"additionalProperties":false}},"additionalProperties":false}},"required":["preferences"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"data":{"type":"object","properties":{"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"data":{"type":"object","properties":{"file":{"type":"object","properties":{"ownerID":{"type":"string"},"ownerType":{"type":"string","minLength":1,"nullable":true},"id":{"type":"string"},"namespace":{"type":"string"},"extension":{"type":"string"},"s3KeyOriginal":{"type":"string"},"userID":{"type":"number","nullable":true},"spaceID":{"type":"string","minLength":1,"nullable":true},"documentID":{"type":"string","minLength":1,"nullable":true},"nodeID":{"type":"string","minLength":1,"nullable":true},"size":{"type":"number"},"mimetype":{"type":"string"},"metadata":{"type":"object","properties":{},"additionalProperties":true},"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["ownerID","id","namespace","extension","s3KeyOriginal","size","mimetype"],"additionalProperties":true}},"required":["file"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false},{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar/anyOf/0"}]},"conversationStarters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"prompt":{"type":"string"}},"required":["id","text"],"additionalProperties":false}}},"additionalProperties":false},"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]},"autoEndChats":{"type":"boolean"},"meta":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"image":{"allOf":[{"$ref":"#/properties/item/properties/data/properties/avatar/anyOf/0/properties/data/properties/file"}],"nullable":true}},"additionalProperties":false}},"additionalProperties":false}},"required":["id","name","data","preferences"],"additionalProperties":false}},"required":["ok","item"],"additionalProperties":false,"description":"Public Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/project":{"post":{"operationId":"agentKnowledgeProjectCreate","tags":["Agent"],"description":"Create a knowledge project","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string"}},"required":["projectId"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Project knowledge created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false,"description":"Project knowledge created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/media":{"post":{"operationId":"agentKnowledgeMediaCreate","tags":["Agent"],"description":"Create a knowledge media","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string"}},"required":["mediaId"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Media knowledge created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false,"description":"Media knowledge created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/project/{projectId}":{"delete":{"operationId":"agentKnowledgeProjectRemove","tags":["Agent"],"description":"Remove a knowledge project","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Project knowledge removed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Project knowledge removed"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/knowledge/media/{mediaId}":{"delete":{"operationId":"agentKnowledgeMediaRemove","tags":["Agent"],"description":"Remove a knowledge media","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Media knowledge removed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Media knowledge removed"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/convos/":{"get":{"operationId":"agentConvosGet","tags":["Agent"],"description":"Get agent conversations","parameters":[{"schema":{"type":"number","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Agent conversations","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Convo"}}},"required":["ok","items"],"additionalProperties":false,"description":"Agent conversations"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/convos/{convoId}":{"get":{"operationId":"agentConvoGet","tags":["Agent"],"description":"Get agent conversation by id","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true},{"schema":{"type":"string"},"in":"path","name":"convoId","required":true}],"responses":{"200":{"description":"Agent conversation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Convo"}},"required":["ok","item"],"additionalProperties":false,"description":"Agent conversation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/medias/{mediaId}":{"get":{"operationId":"mediaGet","tags":["Media"],"description":"Get media with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Media","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"allOf":[{"$ref":"#/components/schemas/Media"}],"nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Media"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"mediaDelete","tags":["Media"],"description":"Delete a media","parameters":[{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true}],"responses":{"200":{"description":"Successful Media deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false,"description":"Successful Media deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/medias/{mediaId}/download":{"get":{"operationId":"mediaDownload","tags":["Media"],"description":"Download the binary content of a media file. Returns the file with the original Content-Type and Content-Disposition headers.","parameters":[{"schema":{"type":"string"},"in":"path","name":"mediaId","required":true,"description":"The SpaceMedia record ID."}],"responses":{"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/medias/spaces/{spaceId}/download":{"get":{"operationId":"mediaDownloadAll","tags":["Media"],"description":"Download all media files from a space as a ZIP archive. Each file is stored as {mediaId}/metadata.json (id, kind, name, mimetype, size) and {mediaId}/original (binary content).","parameters":[{"schema":{"type":"string"},"in":"path","name":"spaceId","required":true,"description":"The space (subspace / app) ID to download all media from."}],"responses":{"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/medias/spaces/{spaceId}/upload":{"post":{"operationId":"mediaUpload","tags":["Media"],"description":"Upload a media file to a space (root workspace or subspace / app). Send the file as the raw request body with the appropriate Content-Type header (e.g. image/png, application/pdf, application/octet-stream). Pass the original filename as the `filename` query parameter.","parameters":[{"schema":{"type":"string"},"in":"query","name":"filename","required":true,"description":"Original filename of the uploaded file (e.g. \"photo.png\")."},{"schema":{"type":"string"},"in":"path","name":"spaceId","required":true,"description":"The space ID to upload media into (can be a root workspace or a subspace / app)."}],"responses":{"200":{"description":"Uploaded media file details","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"mediaId":{"type":"string","description":"The SpaceMedia record ID (UUID)."},"fileId":{"type":"string","description":"The file ID used in S3 (e.g. \"space-files/uuid\")."},"kind":{"type":"string","description":"Detected media kind (image, video, audio, document, etc.)."},"downloadUrl":{"type":"string","description":"Public URL to download the uploaded file."}},"required":["mediaId","fileId","kind","downloadUrl"],"additionalProperties":false}},"required":["ok","item"],"additionalProperties":false,"description":"Uploaded media file details"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bundles/{spaceId}/export":{"get":{"operationId":"bundleExport","tags":["Bundle"],"description":"Export a space (subspace / app) as a JSON bundle (SpaceBundleData v1). Returns all agents, automations, projects, templates, and apps. Media items are excluded — use the ZIP export or download media separately via the media endpoints.","parameters":[{"schema":{"type":"string"},"in":"path","name":"spaceId","required":true,"description":"The space (subspace / app) ID to export."}],"responses":{"200":{"description":"Exported workspace bundle","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"version":{"type":"string","enum":["1"],"description":"Bundle format version."},"items":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"type":"string"}},"required":["type"],"additionalProperties":true},"description":"Map of bundle items keyed by ID. Each item has a `type` field: space-bundle-flow-item, space-bundle-project-item, space-bundle-agent-item, space-bundle-template-item, space-bundle-media-item, space-bundle-app-item."}},"required":["version","items"],"additionalProperties":false,"description":"SpaceBundleData v1 — Workspace DNA bundle."}},"required":["ok","item"],"additionalProperties":false,"description":"Exported workspace bundle"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bundles/{spaceId}/export/zip":{"get":{"operationId":"bundleExportZip","tags":["Bundle"],"description":"Export a space (subspace / app) as a ZIP bundle containing all agents, automations, projects, templates, apps, and media files. The ZIP includes a manifest.json, individual item files in type directories, and media files downloaded from storage.","parameters":[{"schema":{"type":"string","enum":["zip","tsk"],"default":"zip"},"in":"query","name":"format","required":false,"description":"Export format: \"zip\" (default) or \"tsk\" (.tsk app kit)."},{"schema":{"type":"string"},"in":"path","name":"spaceId","required":true,"description":"The space (subspace / app) ID to export."}],"responses":{"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bundles/{workspaceId}/import":{"post":{"operationId":"bundleImport","tags":["Bundle"],"description":"Import a JSON bundle (agents, automations, projects, templates, apps) into a workspace. The bundle is validated against the SpaceBundleData v1 schema and all items are installed into the target workspace. Media items are not supported — use the ZIP import or upload media separately via the media endpoints after import.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bundleData":{"type":"object","properties":{"version":{"type":"string","enum":["1"],"description":"Bundle format version."},"items":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"type":"string"}},"required":["type"],"additionalProperties":true},"description":"Map of bundle items keyed by ID. Each item has a `type` field: space-bundle-flow-item, space-bundle-project-item, space-bundle-agent-item, space-bundle-template-item, space-bundle-media-item, space-bundle-app-item."}},"required":["version","items"],"additionalProperties":false,"description":"The Workspace DNA bundle to import (SpaceBundleData v1)."}},"required":["bundleData"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true,"description":"The target workspace ID to import the bundle into."}],"responses":{"200":{"description":"Successful bundle import","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/BundleInstallation"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful bundle import"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bundles/{workspaceId}/import/zip":{"post":{"operationId":"bundleImportZip","tags":["Bundle"],"description":"Import a ZIP/.tsk bundle (exported from the export/zip endpoint) into a workspace. All items are installed into the target workspace. The ZIP must contain valid bundle data (either bundle.json or directory structure). Media files in the ZIP are re-uploaded to storage automatically. Send the file as the raw request body with Content-Type: application/zip, application/octet-stream, or application/x-tsk.","parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true,"description":"The target workspace ID to import the bundle into."}],"responses":{"200":{"description":"Successful ZIP bundle import","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/BundleInstallation"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful ZIP bundle import"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/public-agents/{publicAgentId}":{"get":{"operationId":"publicAgentGet","tags":["Agent"],"description":"Get public agent by public agent ID","parameters":[{"schema":{"type":"string"},"in":"path","name":"publicAgentId","required":true}],"responses":{"200":{"description":"Public Agent","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"data":{"type":"object","properties":{"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"data":{"type":"object","properties":{"file":{"type":"object","properties":{"ownerID":{"type":"string"},"ownerType":{"type":"string","minLength":1,"nullable":true},"id":{"type":"string"},"namespace":{"type":"string"},"extension":{"type":"string"},"s3KeyOriginal":{"type":"string"},"userID":{"type":"number","nullable":true},"spaceID":{"type":"string","minLength":1,"nullable":true},"documentID":{"type":"string","minLength":1,"nullable":true},"nodeID":{"type":"string","minLength":1,"nullable":true},"size":{"type":"number"},"mimetype":{"type":"string"},"metadata":{"type":"object","properties":{},"additionalProperties":true},"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["ownerID","id","namespace","extension","s3KeyOriginal","size","mimetype"],"additionalProperties":true}},"required":["file"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false},{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar/anyOf/0"}]},"conversationStarters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","minLength":1},"prompt":{"type":"string"}},"required":["id","text"],"additionalProperties":false}}},"additionalProperties":false},"preferences":{"type":"object","properties":{"mode":{"type":"string","enum":["template","chatbot"]},"canCopyKnowledge":{"type":"boolean"},"hideBranding":{"type":"boolean"},"theme":{"type":"string","enum":["light","dark","auto"]},"autoEndChats":{"type":"boolean"},"meta":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"image":{"allOf":[{"$ref":"#/properties/item/properties/data/properties/avatar/anyOf/0/properties/data/properties/file"}],"nullable":true}},"additionalProperties":false}},"additionalProperties":false}},"required":["id","name","data","preferences"],"additionalProperties":false},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","item","publicUrl"],"additionalProperties":false,"description":"Public Agent"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"servers":[{"url":"https://www.taskade.com/api/v1","description":"Public API server"}],"security":[{"oAuthAuthorizationCode":[],"personalAccessToken":[]}]} \ No newline at end of file diff --git a/.gitbook/assets/json (1).json b/.gitbook/assets/json (1).json deleted file mode 100644 index b4e7f51..0000000 --- a/.gitbook/assets/json (1).json +++ /dev/null @@ -1,1437 +0,0 @@ -{ - "openapi": "3.0.3", - "info": { - "title": "Taskade Public API", - "description": "Taskade, the AI-Powered Productivity Platform.", - "version": "0.1.0" - }, - "components": { - "securitySchemes": { - "oAuthAuthorizationCode": { - "type": "oauth2", - "flows": { - "authorizationCode": { - "authorizationUrl": "https://www.taskade.com/oauth2/authorize", - "tokenUrl": "https://www.taskade.com/oauth2/token", - "scopes": {} - } - } - }, - "personalAccessToken": { "type": "http", "scheme": "bearer" } - }, - "schemas": { - "Project": { - "type": "object", - "properties": { - "id": { "type": "string" }, - "name": { "type": "string" } - }, - "required": ["id"], - "additionalProperties": false - }, - "ProjectShare": { - "type": "object", - "properties": { - "checkUrl": { "type": "string", "format": "uri" }, - "editUrl": { "type": "string", "format": "uri" }, - "viewUrl": { "type": "string", "format": "uri" } - }, - "required": ["editUrl", "viewUrl"], - "additionalProperties": false, - "description": "The share links of a project" - }, - "Error": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [false] }, - "message": { "type": "string" }, - "code": { "type": "string" }, - "statusMessage": { "type": "string" } - }, - "required": ["ok", "message", "code", "statusMessage"], - "additionalProperties": false, - "description": "Error description" - }, - "Task": { - "type": "object", - "properties": { - "id": { "type": "string", "format": "uuid" }, - "text": { "type": "string" }, - "parentId": { "type": "string", "format": "uuid" }, - "completed": { "type": "boolean" } - }, - "required": ["id"], - "additionalProperties": false - }, - "Date": { - "type": "object", - "properties": { - "date": { "type": "string", "example": "yyyy-mm-dd", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, - "time": { - "type": "string", - "example": "hh:mm:ss", - "pattern": "^(?:[0-1][0-9]|[2][0-3]):[0-5][0-9](?::[0-5][0-9])?$", - "nullable": true - }, - "timezone": { "type": "string", "example": "America/New_York", "nullable": true } - }, - "required": ["date"], - "additionalProperties": false - }, - "SpaceAgent": { - "type": "object", - "properties": { - "id": { "type": "string" }, - "name": { "type": "string", "minLength": 1 }, - "space_id": { "type": "string" }, - "data": { - "type": "object", - "properties": { - "commands": { - "type": "array", - "items": { - "type": "object", - "properties": { - "name": { "type": "string", "minLength": 1 }, - "prompt": { "type": "string", "minLength": 1 }, - "id": { "type": "string", "minLength": 1 }, - "isBackgroundJob": { "type": "boolean", "default": false }, - "searchToolEnabled": { "type": "boolean" } - }, - "required": ["name", "prompt", "id"], - "additionalProperties": false - } - }, - "description": { "type": "string" }, - "persona": { - "type": "string", - "enum": [ - "standup-comedian", - "life-coach", - "career-counselor", - "nutritionist", - "product-manager", - "personal-trainer", - "life-hacker", - "travel-advisor", - "mindfulness-coach", - "financial-advisor", - "language-tutor", - "travel-guide", - "marketing-expert", - "software-developer", - "diy-expert", - "journalist", - "tech-writer", - "professional-chef", - "professional-salesperson", - "startup-tech-lawyer", - "startup-idea-generator", - "graphic-designer", - "academic-researcher", - "customer-support-agent", - "hr-consultant" - ] - }, - "tone": { - "type": "string", - "enum": [ - "authoritative", - "clinical", - "cold", - "confident", - "cynical", - "emotional", - "empathetic", - "formal", - "friendly", - "humourous", - "informal", - "ironic", - "optimistic", - "pessimistic", - "playful", - "sarcastic", - "serious", - "sympathetic", - "tentative", - "warm", - "creative", - "inspiring", - "casual" - ] - }, - "avatar": { - "anyOf": [ - { - "type": "object", - "properties": { - "type": { "type": "string", "enum": ["emoji"] }, - "data": { - "type": "object", - "properties": { "value": { "type": "string" } }, - "required": ["value"], - "additionalProperties": false - } - }, - "required": ["type", "data"], - "additionalProperties": false - } - ] - }, - "knowledgeEnabled": { "type": "boolean" } - }, - "required": ["commands"], - "additionalProperties": false - } - }, - "required": ["id", "name", "space_id", "data"], - "additionalProperties": false - } - } - }, - "paths": { - "/workspaces/{workspaceId}/projects": { - "post": { - "operationId": "workspaceCreateProject", - "tags": ["Workspace"], - "description": "Create a project in a workspace", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "enum": ["text/markdown"] - }, - "content": { "type": "string" } - }, - "required": ["contentType", "content"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "workspaceId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Project creation", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { "$ref": "#/components/schemas/Project" } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Project creation" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/workspaces": { - "get": { - "operationId": "workspacesGet", - "tags": ["Workspace"], - "description": "Get all workspaces for a user", - "responses": { - "200": { - "description": "Workspaces", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "items": { - "type": "array", - "items": { - "type": "object", - "properties": { - "id": { "type": "string" }, - "name": { "type": "string" } - }, - "required": ["id", "name"], - "additionalProperties": false, - "nullable": true - } - } - }, - "required": ["ok", "items"], - "additionalProperties": false, - "description": "Workspaces" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/workspaces/{workspaceId}/folders": { - "get": { - "operationId": "workspaceFoldersGet", - "tags": ["Workspace"], - "description": "Get all folders for a workspace", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "workspaceId", - "required": true - } - ], - "responses": { - "200": { - "description": "Folders", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "items": { - "type": "array", - "items": { - "type": "object", - "properties": { - "id": { "type": "string" }, - "name": { "type": "string" } - }, - "required": ["id", "name"], - "additionalProperties": false, - "nullable": true - } - } - }, - "required": ["ok", "items"], - "additionalProperties": false, - "description": "Folders" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/copy": { - "post": { - "operationId": "projectCopy", - "tags": ["Project"], - "description": "Copy a project to a folder", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "folderId": { "type": "string", "minLength": 1 }, - "projectTitle": { "type": "string", "minLength": 1 } - }, - "required": ["folderId"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Project Copied", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean" }, - "item": { - "$ref": "#/components/schemas/Project", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Project Copied" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects": { - "post": { - "operationId": "projectCreate", - "tags": ["Project"], - "description": "Create a project in a folder", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "folderId": { "type": "string", "minLength": 1 }, - "contentType": { - "type": "string", - "enum": ["text/markdown"] - }, - "content": { "type": "string" } - }, - "required": ["folderId", "contentType", "content"], - "additionalProperties": false - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "Successful Project creation", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean" }, - "item": { - "$ref": "#/components/schemas/Project", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Project creation" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/shareLink": { - "get": { - "operationId": "projectShareLinkGet", - "tags": ["Project"], - "description": "Get share link for the project", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - } - ], - "responses": { - "200": { - "description": "Share link", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/ProjectShare", - "nullable": true, - "description": "The share links of a project" - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Share link" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - }, - "put": { - "operationId": "projectShareLinkEnable", - "tags": ["Project"], - "description": "Enable share link in the project", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - } - ], - "responses": { - "200": { - "description": "Share link successfully created", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { "$ref": "#/components/schemas/ProjectShare" } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Share link successfully created" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks": { - "get": { - "operationId": "projectTasksGet", - "tags": ["Project"], - "description": "Get all tasks for a project", - "parameters": [ - { - "schema": { "type": "number", "default": 100 }, - "in": "query", - "name": "limit", - "required": false - }, - { - "schema": { "type": "string", "format": "uuid" }, - "in": "query", - "name": "after", - "required": false, - "description": "Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after." - }, - { - "schema": { "type": "string", "format": "uuid" }, - "in": "query", - "name": "before", - "required": false, - "description": "Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after." - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - } - ], - "responses": { - "200": { - "description": "Tasks", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "items": { - "type": "array", - "items": { "$ref": "#/components/schemas/Task" } - } - }, - "required": ["ok", "items"], - "additionalProperties": false, - "description": "Tasks" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/{taskId}/complete": { - "post": { - "operationId": "taskComplete", - "tags": ["Task"], - "description": "Complete a task in a project", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful complete a Task", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful complete a Task" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/": { - "post": { - "operationId": "taskCreate", - "tags": ["Task"], - "description": "Create a task in a project", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "tasks": { - "type": "array", - "items": { - "allOf": [ - { - "type": "object", - "properties": { - "contentType": { - "type": "string", - "enum": ["text/markdown", "text/plain"] - }, - "content": { "type": "string", "maxLength": 2000 } - }, - "required": ["contentType", "content"] - }, - { - "anyOf": [ - { - "type": "object", - "properties": { - "taskId": { - "enum": ["null"], - "nullable": true - }, - "placement": { - "type": "string", - "enum": ["afterbegin", "beforeend"] - } - }, - "required": ["placement"], - "additionalProperties": false - }, - { - "type": "object", - "properties": { - "taskId": { "type": "string" }, - "placement": { - "type": "string", - "enum": [ - "beforebegin", - "afterbegin", - "beforeend", - "afterend" - ] - } - }, - "required": ["taskId", "placement"], - "additionalProperties": false - } - ] - } - ] - }, - "maxItems": 20 - } - }, - "required": ["tasks"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Tasks creation", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "type": "array", - "items": { "$ref": "#/components/schemas/Task" } - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Tasks creation" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/{taskId}": { - "delete": { - "operationId": "taskDelete", - "tags": ["Task"], - "description": "Delete a task in a project", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Task deletion", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Task deletion" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - }, - "get": { - "operationId": "taskGet", - "tags": ["Task"], - "description": "Get task with id", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Task", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean" }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Task" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}": { - "delete": { - "operationId": "taskDeleteAssignees", - "tags": ["Task"], - "description": "Remove assignee from a task", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "assigneeHandle", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Task Assignment deletion", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Task Assignment deletion" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/{taskId}/date": { - "delete": { - "operationId": "taskDeleteDate", - "tags": ["Task"], - "description": "Delete date of a task", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Task Date deletion", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Task Date deletion" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - }, - "put": { - "operationId": "taskPutDate", - "tags": ["Task"], - "description": "Create or update date for a task", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "start": { "$ref": "#/components/schemas/Date" }, - "end": { "$ref": "#/components/schemas/Date" } - }, - "required": ["start"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Task Date create or update", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Task Date create or update" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/projects/{projectId}/tasks/{taskId}/assignees": { - "put": { - "operationId": "taskPutAssignees", - "tags": ["Task"], - "description": "Task assignment", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "handles": { - "type": "array", - "items": { "type": "string", "minLength": 1 } - } - }, - "required": ["handles"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "projectId", - "required": true - }, - { - "schema": { "type": "string" }, - "in": "path", - "name": "taskId", - "required": true - } - ], - "responses": { - "200": { - "description": "Successful Task assignment", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { - "$ref": "#/components/schemas/Task", - "nullable": true - } - }, - "required": ["ok", "item"], - "additionalProperties": false, - "description": "Successful Task assignment" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/folders/{folderId}/projects": { - "get": { - "operationId": "folderProjectsGet", - "tags": ["Folder"], - "description": "Get all projects in a folder, or in the home folder of a workspace.", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "folderId", - "required": true - } - ], - "responses": { - "200": { - "description": "Projects", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "items": { - "type": "array", - "items": { - "$ref": "#/components/schemas/Project", - "nullable": true - } - } - }, - "required": ["ok", "items"], - "additionalProperties": false, - "description": "Projects" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/folders/{folderId}/agents": { - "post": { - "operationId": "folderCreateAgent", - "tags": ["Folder"], - "description": "Create an agent in a folder, or in the home folder of a workspace.", - "requestBody": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "name": { "type": "string" }, - "data": { - "anyOf": [ - { - "type": "object", - "properties": { - "type": { "type": "string", "enum": ["data"] }, - "data": { - "$ref": "#/components/schemas/SpaceAgent/properties/data" - } - }, - "required": ["type", "data"], - "additionalProperties": false - }, - { - "type": "object", - "properties": { - "type": { "type": "string", "enum": ["template"] }, - "template": { - "type": "object", - "properties": { - "type": { - "type": "string", - "enum": [ - "Tasker", - "Researcher", - "Marketer", - "EmailWriter", - "Sales", - "CustomerSupport", - "ProjectManager", - "ContentCreator", - "Copywriter", - "LegalAdvisor", - "SeoSpecialist", - "ProductivityCoach", - "EngineeringExpert", - "Translator", - "Summarizer", - "ResumeBuilder", - "Storyteller", - "Tutor", - "BrandStrategist", - "SocialMediaSpecialist", - "BusinessStrategist", - "FinancialAnalyst", - "HumanResourcesManager", - "DataScientist", - "ITConsultant", - "FinancialAdvisor", - "HealthCoach", - "SustainabilityConsultant", - "UXDesigner", - "QualityAssuranceAnalyst", - "ProductManager", - "GrowthHacker", - "BusinessDevelopmentManager", - "PublicRelationsSpecialist", - "EventPlanner", - "DataAnalyst", - "Editor", - "CEO", - "InterviewCoach", - "TechSupportAdvisor", - "Doctor", - "BlogExpert", - "TweetOptimizer", - "EmailMarketer", - "CourseCreator", - "ScriptCreator", - "ScreenplayWriter", - "Proofreader", - "SalesColdEmailCoach", - "CodeExplainer", - "CreativeWritingCoach", - "AdvertisingCopywriter", - "VideoScriptWriter" - ] - }, - "avatar": { - "$ref": "#/components/schemas/SpaceAgent/properties/data/properties/avatar" - } - }, - "required": ["type"], - "additionalProperties": false - } - }, - "required": ["type", "template"], - "additionalProperties": false - } - ] - } - }, - "required": ["name", "data"], - "additionalProperties": false - } - } - }, - "required": true - }, - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "folderId", - "required": true - } - ], - "responses": { - "200": { - "description": "Default response", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "item": { "$ref": "#/components/schemas/SpaceAgent" } - }, - "required": ["ok", "item"], - "additionalProperties": false - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/me/projects": { - "get": { - "operationId": "meProjectsGet", - "tags": ["Me"], - "description": "Get all projects of mine", - "parameters": [ - { - "schema": { "type": "number", "default": 100 }, - "in": "query", - "name": "limit", - "required": false - }, - { - "schema": { "type": "number", "default": 1 }, - "in": "query", - "name": "page", - "required": false - }, - { - "schema": { - "type": "string", - "enum": ["viewed-asc", "viewed-desc"], - "default": "viewed-desc" - }, - "in": "query", - "name": "sort", - "required": false - } - ], - "responses": { - "200": { - "description": "Projects", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "items": { - "type": "array", - "items": { "$ref": "#/components/schemas/Project" } - } - }, - "required": ["ok", "items"], - "additionalProperties": false, - "description": "Projects" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - }, - "/agents/{agentId}/publicAccess": { - "put": { - "operationId": "agentPublicAccessEnable", - "tags": ["Agent"], - "description": "Enable public access in the agent", - "parameters": [ - { - "schema": { "type": "string" }, - "in": "path", - "name": "agentId", - "required": true - } - ], - "responses": { - "200": { - "description": "Public access successfully enabled", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "ok": { "type": "boolean", "enum": [true] }, - "publicUrl": { "type": "string", "format": "uri" } - }, - "required": ["ok", "publicUrl"], - "additionalProperties": false, - "description": "Public access successfully enabled" - } - } - } - }, - "4XX": { - "description": "Error description", - "content": { - "application/json": { - "schema": { "$ref": "#/components/schemas/Error" } - } - } - } - } - } - } - }, - "servers": [ - { - "url": "https://www.taskade.com/api/v1", - "description": "Public API server" - } - ], - "security": [{ "oAuthAuthorizationCode": [], "personalAccessToken": [] }] -} diff --git a/.gitbook/assets/json.json b/.gitbook/assets/json.json deleted file mode 100644 index 4788d4b..0000000 --- a/.gitbook/assets/json.json +++ /dev/null @@ -1 +0,0 @@ -{"openapi":"3.0.3","info":{"title":"Taskade Public API","description":"Taskade, the AI-Powered Productivity Platform.","version":"0.1.0"},"components":{"securitySchemes":{"oAuthAuthorizationCode":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.taskade.com/oauth2/authorize","tokenUrl":"https://www.taskade.com/oauth2/token","scopes":{}}}},"personalAccessToken":{"type":"http","scheme":"bearer"}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false},"ProjectShare":{"type":"object","properties":{"checkUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"},"viewUrl":{"type":"string","format":"uri"}},"required":["editUrl","viewUrl"],"additionalProperties":false,"description":"The share links of a project"},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"message":{"type":"string"},"code":{"type":"string"},"statusMessage":{"type":"string"}},"required":["ok","message","code","statusMessage"],"additionalProperties":false,"description":"Error description"},"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"text":{"type":"string"},"parentId":{"type":"string","format":"uuid"},"completed":{"type":"boolean"}},"required":["id"],"additionalProperties":false},"Date":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"time":{"type":"string","pattern":"^(?:[0-1][0-9]|[2][0-3]):[0-5][0-9](?::[0-5][0-9])?$","nullable":true},"timezone":{"type":"string","nullable":true}},"required":["date"],"additionalProperties":false},"SpaceAgent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":1},"space_id":{"type":"string"},"data":{"type":"object","properties":{"commands":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"prompt":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"isBackgroundJob":{"type":"boolean","default":false},"searchToolEnabled":{"type":"boolean"}},"required":["name","prompt","id"],"additionalProperties":false}},"description":{"type":"string"},"persona":{"type":"string","enum":["standup-comedian","life-coach","career-counselor","nutritionist","product-manager","personal-trainer","life-hacker","travel-advisor","mindfulness-coach","financial-advisor","language-tutor","travel-guide","marketing-expert","software-developer","diy-expert","journalist","tech-writer","professional-chef","professional-salesperson","startup-tech-lawyer","startup-idea-generator","graphic-designer","academic-researcher","customer-support-agent","hr-consultant"]},"tone":{"type":"string","enum":["authoritative","clinical","cold","confident","cynical","emotional","empathetic","formal","friendly","humourous","informal","ironic","optimistic","pessimistic","playful","sarcastic","serious","sympathetic","tentative","warm","creative","inspiring","casual"]},"avatar":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"data":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"],"additionalProperties":false}},"required":["type","data"],"additionalProperties":false}]},"knowledgeEnabled":{"type":"boolean"}},"required":["commands"],"additionalProperties":false}},"required":["id","name","space_id","data"],"additionalProperties":false}}},"paths":{"/workspaces/{workspaceId}/projects":{"post":{"operationId":"workspaceCreateProject","tags":["Workspace"],"description":"Create a project in a workspace","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["contentType","content"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces":{"get":{"operationId":"workspacesGet","tags":["Workspace"],"description":"Get all workspaces for a user","responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Workspaces"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces/{workspaceId}/folders":{"get":{"operationId":"workspaceFoldersGet","tags":["Workspace"],"description":"Get all folders for a workspace","parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Folders","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Folders"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/copy":{"post":{"operationId":"projectCopy","tags":["Project"],"description":"Copy a project to a folder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"projectTitle":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Project Copied","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Project","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project Copied"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"post":{"operationId":"projectCreate","tags":["Project"],"description":"Create a project in a folder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["folderId","contentType","content"],"additionalProperties":false}}},"required":true},"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Project","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/shareLink":{"get":{"operationId":"projectShareLinkGet","tags":["Project"],"description":"Get share link for the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare","nullable":true,"description":"The share links of a project"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"projectShareLinkEnable","tags":["Project"],"description":"Enable share link in the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link successfully created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks":{"get":{"operationId":"projectTasksGet","tags":["Project"],"description":"Get all tasks for a project","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"after","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"before","required":false,"description":"Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after."},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Tasks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","items"],"additionalProperties":false,"description":"Tasks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/complete":{"post":{"operationId":"taskComplete","tags":["Task"],"description":"Complete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful complete a Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful complete a Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/":{"post":{"operationId":"taskCreate","tags":["Task"],"description":"Create a task in a project","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"allOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","maxLength":2000}},"required":["contentType","content"]},{"anyOf":[{"type":"object","properties":{"taskId":{"enum":["null"],"nullable":true},"placement":{"type":"string","enum":["afterbegin","beforeend"]}},"required":["placement"],"additionalProperties":false},{"type":"object","properties":{"taskId":{"type":"string"},"placement":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","placement"],"additionalProperties":false}]}]},"maxItems":20}},"required":["tasks"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Tasks creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Tasks creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}":{"delete":{"operationId":"taskDelete","tags":["Task"],"description":"Delete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"taskGet","tags":["Task"],"description":"Get task with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}":{"delete":{"operationId":"taskDeleteAssignees","tags":["Task"],"description":"Remove assignee from a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"assigneeHandle","required":true}],"responses":{"200":{"description":"Successful Task Assignment deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Assignment deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/date":{"delete":{"operationId":"taskDeleteDate","tags":["Task"],"description":"Delete date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutDate","tags":["Task"],"description":"Create or update date for a task","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"$ref":"#/components/schemas/Date"}},"required":["start"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date create or update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date create or update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees":{"put":{"operationId":"taskPutAssignees","tags":["Task"],"description":"Task assignment","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"array","items":{"type":"string","minLength":1}}},"required":["handles"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task assignment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task assignment"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/projects":{"get":{"operationId":"folderProjectsGet","tags":["Folder"],"description":"Get all projects in a folder, or in the home folder of a workspace.","parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project","nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/agents":{"post":{"operationId":"folderCreateAgent","tags":["Folder"],"description":"Create an agent in a folder, or in the home folder of a workspace.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["data"]},"data":{"$ref":"#/components/schemas/SpaceAgent/properties/data"}},"required":["type","data"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["template"]},"template":{"type":"object","properties":{"type":{"type":"string","enum":["Tasker","Researcher","Marketer","EmailWriter","Sales","CustomerSupport","ProjectManager","ContentCreator","Copywriter","LegalAdvisor","SeoSpecialist","ProductivityCoach","EngineeringExpert","Translator","Summarizer","ResumeBuilder","Storyteller","Tutor","BrandStrategist","SocialMediaSpecialist","BusinessStrategist","FinancialAnalyst","HumanResourcesManager","DataScientist","ITConsultant","FinancialAdvisor","HealthCoach","SustainabilityConsultant","UXDesigner","QualityAssuranceAnalyst","ProductManager","GrowthHacker","BusinessDevelopmentManager","PublicRelationsSpecialist","EventPlanner","DataAnalyst","Editor","CEO","InterviewCoach","TechSupportAdvisor","Doctor","BlogExpert","TweetOptimizer","EmailMarketer","CourseCreator","ScriptCreator","ScreenplayWriter","Proofreader","SalesColdEmailCoach","CodeExplainer","CreativeWritingCoach","AdvertisingCopywriter","VideoScriptWriter"]},"avatar":{"$ref":"#/components/schemas/SpaceAgent/properties/data/properties/avatar"}},"required":["type"],"additionalProperties":false}},"required":["type","template"],"additionalProperties":false}]}},"required":["name","data"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Default response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/SpaceAgent"}},"required":["ok","item"],"additionalProperties":false}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/projects":{"get":{"operationId":"meProjectsGet","tags":["Me"],"description":"Get all projects of mine","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string","enum":["viewed-asc","viewed-desc"],"default":"viewed-desc"},"in":"query","name":"sort","required":false}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{agentId}/publicAccess":{"put":{"operationId":"agentPublicAccessEnable","tags":["Agent"],"description":"Enable public access in the agent","parameters":[{"schema":{"type":"string"},"in":"path","name":"agentId","required":true}],"responses":{"200":{"description":"Public access successfully enabled","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"publicUrl":{"type":"string","format":"uri"}},"required":["ok","publicUrl"],"additionalProperties":false,"description":"Public access successfully enabled"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"servers":[{"url":"https://www.taskade.com/api/v1","description":"Public API server"}],"security":[{"oAuthAuthorizationCode":[],"personalAccessToken":[]}]} \ No newline at end of file diff --git a/.gitbook/assets/openapi taskade.json b/.gitbook/assets/openapi taskade.json deleted file mode 100644 index 0a11504..0000000 --- a/.gitbook/assets/openapi taskade.json +++ /dev/null @@ -1 +0,0 @@ -{"openapi":"3.0.3","info":{"title":"Taskade Public API","description":"Taskade, the AI-Powered Productivity Platform.","version":"0.1.0"},"components":{"securitySchemes":{"oAuthAuthorizationCode":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.taskade.com/oauth2/authorize","tokenUrl":"https://www.taskade.com/oauth2/token","scopes":{}}}},"personalAccessToken":{"type":"http","scheme":"bearer"}},"schemas":{"Project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false},"ProjectShare":{"type":"object","properties":{"checkUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"},"viewUrl":{"type":"string","format":"uri"}},"required":["editUrl","viewUrl"],"additionalProperties":false,"description":"The share links of a project"},"Error":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"message":{"type":"string"},"code":{"type":"string"},"statusMessage":{"type":"string"}},"required":["ok","message","code","statusMessage"],"additionalProperties":false,"description":"Error description"},"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"text":{"type":"string"},"parentId":{"type":"string","format":"uuid"},"completed":{"type":"boolean"}},"required":["id"],"additionalProperties":false},"Date":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"time":{"type":"string","pattern":"^(?:[0-1][0-9]|[2][0-3]):[0-5][0-9](?::[0-5][0-9])?$","nullable":true},"timezone":{"type":"string","nullable":true}},"required":["date"],"additionalProperties":false}}},"paths":{"/workspaces/{workspaceId}/projects":{"post":{"operationId":"workspaceCreateProject","tags":["Workspace"],"description":"Create a project in a workspace","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["contentType","content"],"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Project"}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces":{"get":{"operationId":"workspacesGet","tags":["Workspace"],"description":"Get all workspaces for a user","responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Workspaces"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspaces/{workspaceId}/folders":{"get":{"operationId":"workspaceFoldersGet","tags":["Workspace"],"description":"Get all folders for a workspace","parameters":[{"schema":{"type":"string"},"in":"path","name":"workspaceId","required":true}],"responses":{"200":{"description":"Folders","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Folders"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/copy":{"post":{"operationId":"projectCopy","tags":["Project"],"description":"Copy a project to a folder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folderId":{"type":"string","minLength":1},"projectTitle":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Project Copied","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Project","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project Copied"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects":{"post":{"operationId":"projectCreate","tags":["Project"],"description":"Create a project in a folder","requestBody":{"content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"folderId":{"type":"string","minLength":1}},"required":["folderId"]},{"anyOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown"]},"content":{"type":"string"}},"required":["contentType","content"],"additionalProperties":false},{"type":"object","properties":{"fromTemplateId":{"type":"string","minLength":1}},"required":["fromTemplateId"],"additionalProperties":false}]}]}}}},"responses":{"200":{"description":"Successful Project creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Project","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Project creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/shareLink":{"get":{"operationId":"projectShareLinkGet","tags":["Project"],"description":"Get share link for the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare","nullable":true,"description":"The share links of a project"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"projectShareLinkEnable","tags":["Project"],"description":"Enable share link in the project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Share link successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/ProjectShare"}},"required":["ok","item"],"additionalProperties":false,"description":"Share link successfully created"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks":{"get":{"operationId":"projectTasksGet","tags":["Project"],"description":"Get all tasks for a project","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"not":{}},"in":"query","name":"after","required":false},{"schema":{"not":{}},"in":"query","name":"before","required":false},{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Tasks","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","items"],"additionalProperties":false,"description":"Tasks"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/complete":{"post":{"operationId":"taskComplete","tags":["Task"],"description":"Complete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful complete a Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful complete a Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/":{"post":{"operationId":"taskCreate","tags":["Task"],"description":"Create a task in a project","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"allOf":[{"type":"object","properties":{"contentType":{"type":"string","enum":["text/markdown","text/plain"]},"content":{"type":"string","maxLength":2000}},"required":["contentType","content"]},{"anyOf":[{"type":"object","properties":{"taskId":{"enum":["null"],"nullable":true},"placement":{"type":"string","enum":["afterbegin","beforeend"]}},"required":["placement"],"additionalProperties":false},{"type":"object","properties":{"taskId":{"type":"string"},"placement":{"type":"string","enum":["beforebegin","afterbegin","beforeend","afterend"]}},"required":["taskId","placement"],"additionalProperties":false}]}]},"maxItems":20}},"required":["tasks"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true}],"responses":{"200":{"description":"Successful Tasks creation","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Tasks creation"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}":{"delete":{"operationId":"taskDelete","tags":["Task"],"description":"Delete a task in a project","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"taskGet","tags":["Task"],"description":"Get task with id","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Task","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Task"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}":{"delete":{"operationId":"taskDeleteAssignees","tags":["Task"],"description":"Remove assignee from a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true},{"schema":{"type":"string"},"in":"path","name":"assigneeHandle","required":true}],"responses":{"200":{"description":"Successful Task Assignment deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Assignment deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/date":{"delete":{"operationId":"taskDeleteDate","tags":["Task"],"description":"Delete date of a task","parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date deletion","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date deletion"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"taskPutDate","tags":["Task"],"description":"Create or update date for a task","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"$ref":"#/components/schemas/Date"},"end":{"$ref":"#/components/schemas/Date"}},"required":["start"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task Date create or update","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task Date create or update"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/projects/{projectId}/tasks/{taskId}/assignees":{"put":{"operationId":"taskPutAssignees","tags":["Task"],"description":"Task assignment","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"handles":{"type":"array","items":{"type":"string","minLength":1}}},"required":["handles"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"projectId","required":true},{"schema":{"type":"string"},"in":"path","name":"taskId","required":true}],"responses":{"200":{"description":"Successful Task assignment","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"item":{"$ref":"#/components/schemas/Task","nullable":true}},"required":["ok","item"],"additionalProperties":false,"description":"Successful Task assignment"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/folders/{folderId}/projects":{"get":{"operationId":"folderProjectsGet","tags":["Folder"],"description":"Get all projects in a folder, or in the home folder of a workspace.","parameters":[{"schema":{"type":"string"},"in":"path","name":"folderId","required":true}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project","nullable":true}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/projects":{"get":{"operationId":"meProjectsGet","tags":["Me"],"description":"Get all projects of mine","parameters":[{"schema":{"type":"number","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"number","default":1},"in":"query","name":"page","required":false},{"schema":{"type":"string","enum":["viewed-asc","viewed-desc"],"default":"viewed-desc"},"in":"query","name":"sort","required":false}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}},"required":["ok","items"],"additionalProperties":false,"description":"Projects"}}}},"4XX":{"description":"Error description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"servers":[{"url":"https://www.taskade.com/api/v1","description":"Public API server"}],"security":[{"oAuthAuthorizationCode":[],"personalAccessToken":[]}]} \ No newline at end of file diff --git a/.gitignore b/.gitignore index dc41e9e..66e6762 100644 --- a/.gitignore +++ b/.gitignore @@ -81,3 +81,4 @@ coverage/ # Temporary folders tmp/ temp/ +SUBMISSIONS_TRACKER_*.md diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..da6ab6c --- /dev/null +++ b/LICENSE @@ -0,0 +1,396 @@ +Attribution 4.0 International + +======================================================================= + +Creative Commons Corporation ("Creative Commons") is not a law firm and +does not provide legal services or legal advice. Distribution of +Creative Commons public licenses does not create a lawyer-client or +other relationship. Creative Commons makes its licenses and related +information available on an "as-is" basis. Creative Commons gives no +warranties regarding its licenses, any material licensed under their +terms and conditions, or any related information. Creative Commons +disclaims all liability for damages resulting from their use to the +fullest extent possible. + +Using Creative Commons Public Licenses + +Creative Commons public licenses provide a standard set of terms and +conditions that creators and other rights holders may use to share +original works of authorship and other material subject to copyright +and certain other rights specified in the public license below. The +following considerations are for informational purposes only, are not +exhaustive, and do not form part of our licenses. + + Considerations for licensors: Our public licenses are + intended for use by those authorized to give the public + permission to use material in ways otherwise restricted by + copyright and certain other rights. Our licenses are + irrevocable. Licensors should read and understand the terms + and conditions of the license they choose before applying it. + Licensors should also secure all rights necessary before + applying our licenses so that the public can reuse the + material as expected. Licensors should clearly mark any + material not subject to the license. This includes other CC- + licensed material, or material used under an exception or + limitation to copyright. More considerations for licensors: + wiki.creativecommons.org/Considerations_for_licensors + + Considerations for the public: By using one of our public + licenses, a licensor grants the public permission to use the + licensed material under specified terms and conditions. If + the licensor's permission is not necessary for any reason--for + example, because of any applicable exception or limitation to + copyright--then that use is not regulated by the license. Our + licenses grant only permissions under copyright and certain + other rights that a licensor has authority to grant. Use of + the licensed material may still be restricted for other + reasons, including because others have copyright or other + rights in the material. A licensor may make special requests, + such as asking that all changes be marked or described. + Although not required by our licenses, you are encouraged to + respect those requests where reasonable. More considerations + for the public: + wiki.creativecommons.org/Considerations_for_licensees + +======================================================================= + +Creative Commons Attribution 4.0 International Public License + +By exercising the Licensed Rights (defined below), You accept and agree +to be bound by the terms and conditions of this Creative Commons +Attribution 4.0 International Public License ("Public License"). To the +extent this Public License may be interpreted as a contract, You are +granted the Licensed Rights in consideration of Your acceptance of +these terms and conditions, and the Licensor grants You such rights in +consideration of benefits the Licensor receives from making the +Licensed Material available under these terms and conditions. + + +Section 1 -- Definitions. + + a. Adapted Material means material subject to Copyright and Similar + Rights that is derived from or based upon the Licensed Material + and in which the Licensed Material is translated, altered, + arranged, transformed, or otherwise modified in a manner requiring + permission under the Copyright and Similar Rights held by the + Licensor. For purposes of this Public License, where the Licensed + Material is a musical work, performance, or sound recording, + Adapted Material is always produced where the Licensed Material is + synched in timed relation with a moving image. + + b. Adapter's License means the license You apply to Your Copyright + and Similar Rights in Your contributions to Adapted Material in + accordance with the terms and conditions of this Public License. + + c. Copyright and Similar Rights means copyright and/or similar rights + closely related to copyright including, without limitation, + performance, broadcast, sound recording, and Sui Generis Database + Rights, without regard to how the rights are labeled or + categorized. For purposes of this Public License, the rights + specified in Section 2(b)(1)-(2) are not Copyright and Similar + Rights. + + d. Effective Technological Measures means those measures that, in the + absence of proper authority, may not be circumvented under laws + fulfilling obligations under Article 11 of the WIPO Copyright + Treaty adopted on December 20, 1996, and/or similar international + agreements. + + e. Exceptions and Limitations means fair use, fair dealing, and/or + any other exception or limitation to Copyright and Similar Rights + that applies to Your use of the Licensed Material. + + f. Licensed Material means the artistic or literary work, database, + or other material to which the Licensor applied this Public + License. + + g. Licensed Rights means the rights granted to You subject to the + terms and conditions of this Public License, which are limited to + all Copyright and Similar Rights that apply to Your use of the + Licensed Material and that the Licensor has authority to license. + + h. Licensor means the individual(s) or entity(ies) granting rights + under this Public License. + + i. Share means to provide material to the public by any means or + process that requires permission under the Licensed Rights, such + as reproduction, public display, public performance, distribution, + dissemination, communication, or importation, and to make material + available to the public including in ways that members of the + public may access the material from a place and at a time + individually chosen by them. + + j. Sui Generis Database Rights means rights other than copyright + resulting from Directive 96/9/EC of the European Parliament and of + the Council of 11 March 1996 on the legal protection of databases, + as amended and/or succeeded, as well as other essentially + equivalent rights anywhere in the world. + + k. You means the individual or entity exercising the Licensed Rights + under this Public License. Your has a corresponding meaning. + + +Section 2 -- Scope. + + a. License grant. + + 1. Subject to the terms and conditions of this Public License, + the Licensor hereby grants You a worldwide, royalty-free, + non-sublicensable, non-exclusive, irrevocable license to + exercise the Licensed Rights in the Licensed Material to: + + a. reproduce and Share the Licensed Material, in whole or + in part; and + + b. produce, reproduce, and Share Adapted Material. + + 2. Exceptions and Limitations. For the avoidance of doubt, where + Exceptions and Limitations apply to Your use, this Public + License does not apply, and You do not need to comply with + its terms and conditions. + + 3. Term. The term of this Public License is specified in Section + 6(a). + + 4. Media and formats; technical modifications allowed. The + Licensor authorizes You to exercise the Licensed Rights in + all media and formats whether now known or hereafter created, + and to make technical modifications necessary to do so. The + Licensor waives and/or agrees not to assert any right or + authority to forbid You from making technical modifications + necessary to exercise the Licensed Rights, including + technical modifications necessary to circumvent Effective + Technological Measures. For purposes of this Public License, + simply making modifications authorized by this Section 2(a) + (4) never produces Adapted Material. + + 5. Downstream recipients. + + a. Offer from the Licensor -- Licensed Material. Every + recipient of the Licensed Material automatically + receives an offer from the Licensor to exercise the + Licensed Rights under the terms and conditions of this + Public License. + + b. No downstream restrictions. You may not offer or impose + any additional or different terms or conditions on, or + apply any Effective Technological Measures to, the + Licensed Material if doing so restricts exercise of the + Licensed Rights by any recipient of the Licensed + Material. + + 6. No endorsement. Nothing in this Public License constitutes or + may be construed as permission to assert or imply that You + are, or that Your use of the Licensed Material is, connected + with, or sponsored, endorsed, or granted official status by, + the Licensor or others designated to receive attribution as + provided in Section 3(a)(1)(A)(i). + + b. Other rights. + + 1. Moral rights, such as the right of integrity, are not + licensed under this Public License, nor are publicity, + privacy, and/or other similar personality rights; however, to + the extent possible, the Licensor waives and/or agrees not to + assert any such rights held by the Licensor to the limited + extent necessary to allow You to exercise the Licensed + Rights, but not otherwise. + + 2. Patent and trademark rights are not licensed under this + Public License. + + 3. To the extent possible, the Licensor waives any right to + collect royalties from You for the exercise of the Licensed + Rights, whether directly or through a collecting society + under any voluntary or waivable statutory or compulsory + licensing scheme. In all other cases the Licensor expressly + reserves any right to collect such royalties. + + +Section 3 -- License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the +following conditions. + + a. Attribution. + + 1. If You Share the Licensed Material (including in modified + form), You must: + + a. retain the following if it is supplied by the Licensor + with the Licensed Material: + + i. identification of the creator(s) of the Licensed + Material and any others designated to receive + attribution, in any reasonable manner requested by + the Licensor (including by pseudonym if + designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of + warranties; + + v. a URI or hyperlink to the Licensed Material to the + extent reasonably practicable; + + b. indicate if You modified the Licensed Material and + retain an indication of any previous modifications; and + + c. indicate the Licensed Material is licensed under this + Public License, and include the text of, or the URI or + hyperlink to, this Public License. + + 2. You may satisfy the conditions in Section 3(a)(1) in any + reasonable manner based on the medium, means, and context in + which You Share the Licensed Material. For example, it may be + reasonable to satisfy the conditions by providing a URI or + hyperlink to a resource that includes the required + information. + + 3. If requested by the Licensor, You must remove any of the + information required by Section 3(a)(1)(A) to the extent + reasonably practicable. + + 4. If You Share Adapted Material You produce, the Adapter's + License You apply must not prevent recipients of the Adapted + Material from complying with this Public License. + + +Section 4 -- Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that +apply to Your use of the Licensed Material: + + a. for the avoidance of doubt, Section 2(a)(1) grants You the right + to extract, reuse, reproduce, and Share all or a substantial + portion of the contents of the database; + + b. if You include all or a substantial portion of the database + contents in a database in which You have Sui Generis Database + Rights, then the database in which You have Sui Generis Database + Rights (but not its individual contents) is Adapted Material; and + + c. You must comply with the conditions in Section 3(a) if You Share + all or a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not +replace Your obligations under this Public License where the Licensed +Rights include other Copyright and Similar Rights. + + +Section 5 -- Disclaimer of Warranties and Limitation of Liability. + + a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE + EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS + AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF + ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, + IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, + WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, + ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT + KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT + ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. + + b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE + TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, + NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, + INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, + COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR + USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR + DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR + IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. + + c. The disclaimer of warranties and limitation of liability provided + above shall be interpreted in a manner that, to the extent + possible, most closely approximates an absolute disclaimer and + waiver of all liability. + + +Section 6 -- Term and Termination. + + a. This Public License applies for the term of the Copyright and + Similar Rights licensed here. However, if You fail to comply with + this Public License, then Your rights under this Public License + terminate automatically. + + b. Where Your right to use the Licensed Material has terminated under + Section 6(a), it reinstates: + + 1. automatically as of the date the violation is cured, provided + it is cured within 30 days of Your discovery of the + violation; or + + 2. upon express reinstatement by the Licensor. + + For the avoidance of doubt, this Section 6(b) does not affect any + right the Licensor may have to seek remedies for Your violations + of this Public License. + + c. For the avoidance of doubt, the Licensor may also offer the + Licensed Material under separate terms or conditions or stop + distributing the Licensed Material at any time; however, doing so + will not terminate this Public License. + + d. Sections 1, 5, 6, 7, and 8 survive termination of this Public + License. + + +Section 7 -- Other Terms and Conditions. + + a. The Licensor shall not be bound by any additional or different + terms or conditions communicated by You unless expressly agreed. + + b. Any arrangements, understandings, or agreements regarding the + Licensed Material not stated herein are separate from and + independent of the terms and conditions of this Public License. + + +Section 8 -- Interpretation. + + a. For the avoidance of doubt, this Public License does not, and + shall not be interpreted to, reduce, limit, restrict, or impose + conditions on any use of the Licensed Material that could lawfully + be made without permission under this Public License. + + b. To the extent possible, if any provision of this Public License is + deemed unenforceable, it shall be automatically reformed to the + minimum extent necessary to make it enforceable. If the provision + cannot be reformed, it shall be severed from this Public License + without affecting the enforceability of the remaining terms and + conditions. + + c. No term or condition of this Public License will be waived and no + failure to comply consented to unless expressly agreed to by the + Licensor. + + d. Nothing in this Public License constitutes or may be interpreted + as a limitation upon, or waiver of, any privileges and immunities + that apply to the Licensor or You, including from the legal + processes of any jurisdiction or authority. + + +======================================================================= + +Creative Commons is not a party to its public +licenses. Notwithstanding, Creative Commons may elect to apply one of +its public licenses to material it publishes and in those instances +will be considered the “Licensor.” The text of the Creative Commons +public licenses is dedicated to the public domain under the CC0 Public +Domain Dedication. Except for the limited purpose of indicating that +material is shared under a Creative Commons public license or as +otherwise permitted by the Creative Commons policies published at +creativecommons.org/policies, Creative Commons does not authorize the +use of the trademark "Creative Commons" or any other trademark or logo +of Creative Commons without its prior written consent including, +without limitation, in connection with any unauthorized modifications +to any of its public licenses or any other arrangements, +understandings, or agreements concerning use of licensed material. For +the avoidance of doubt, this paragraph does not form part of the +public licenses. + +Creative Commons may be contacted at creativecommons.org. + diff --git a/README.md b/README.md index 4998dca..faeb8a5 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,7 @@ Use this as the canonical overview: [Workspace DNA](genesis-living-system-builde * [**REST API v1**](apis-living-system-development/comprehensive-api-guide/README.md) - Complete RESTful reference (full task CRUD) * [**Action API v2**](apis-living-system-development/api-v2-reference.md) - The newer action-based API (agent prompting, bundles) * [**Authentication**](apis-living-system-development/developers/authentication.md) - Personal tokens & OAuth 2.0 +* [**Open Source**](https://github.com/taskade) - MCP server, Integration Kit (Zapier/n8n), and sample apps on GitHub ### Explore docs diff --git a/apis-living-system-development/developer-home.md b/apis-living-system-development/developer-home.md index da588bf..8a0c0cc 100644 --- a/apis-living-system-development/developer-home.md +++ b/apis-living-system-development/developer-home.md @@ -85,10 +85,11 @@ Treat your API token like a password. Never commit it to version control or shar | [REST API v1 Reference](comprehensive-api-guide/README.md) | The complete, stable RESTful API — full task CRUD, per-endpoint docs | | [Action API v2 Reference](api-v2-reference.md) | The newer action-based (RPC) API — agent prompting, bundles, lifecycle | | [Authentication Guide](developers/authentication.md) | Personal access tokens and OAuth 2.0 (PKCE) flows | -| [Workspace MCP](workspace-mcp.md) | Run `@taskade/mcp-server` to connect Claude Desktop, Cursor, and Claude Code | +| [Workspace MCP](workspace-mcp.md) | Run `@taskade/mcp-server` to connect Claude Desktop, Cursor, and Claude Code ([source](https://github.com/taskade/mcp)) | | [Workspace MCP — Advanced](workspace-mcp-advanced.md) | Multi-client setup, troubleshooting, security | | [Hosted MCP — Genesis App (Beta)](genesis-app-mcp.md) | Edit your Genesis app's source from your IDE via the remote `taskade.com/mcp` server | | [MCP Connectors](../genesis-living-system-builder/genesis/mcp-connectors.md) | Give Taskade agents 31+ third-party tools (outbound MCP) | +| [Integration Kit (GitHub)](https://github.com/taskade/integrations) | Open-source Zapier and n8n actions & triggers built on the public API — contribute or self-host | | [Webhooks](webhooks.md) | Trigger automations from external events; call out to any API | | [Bundles & App Kits](bundles.md) | Import/export full Genesis apps as portable `.tsk` bundles | | [Long-Term Memory](long-term-memory.md) | Memory-as-Projects architecture — editable, queryable, API-addressable | diff --git a/apis-living-system-development/developers/README.md b/apis-living-system-development/developers/README.md index 50690e3..1fcd9f4 100644 --- a/apis-living-system-development/developers/README.md +++ b/apis-living-system-development/developers/README.md @@ -64,6 +64,7 @@ Official libraries and tools: * [Autonomous Agents Guide](../autonomous-agents.md) -- Agent use cases and architecture patterns * [Community Apps](https://www.taskade.com/community) -- Browse Genesis apps built by the community * [Sample App](https://github.com/taskade/taskade-sample-app) -- Genesis app example +* [Integration Kit](https://github.com/taskade/integrations) -- Open-source Zapier & n8n actions and triggers built on the public API {% endtab %} {% endtabs %} diff --git a/genesis-living-system-builder/automation/advanced-actions.md b/genesis-living-system-builder/automation/advanced-actions.md index 1c434d6..e5e85d9 100644 --- a/genesis-living-system-builder/automation/advanced-actions.md +++ b/genesis-living-system-builder/automation/advanced-actions.md @@ -756,21 +756,13 @@ The HTTP Schema Generator automatically creates data schemas from API responses, --- -## 🔮 Future Automation Features +## 🤖 Build Automations with AI — Available Today -### **Coming Soon** +You don't have to assemble flows by hand — Taskade already builds automations from natural language: -#### **AI-Powered Automation Builder** -- Natural language automation creation -- Smart workflow suggestions based on usage patterns -- Automatic optimization recommendations -- Predictive failure detection - -#### **Advanced Integration Hub** -- One-click setup for popular service combinations -- Custom connector builder -- Real-time integration health monitoring -- Marketplace for community-built integrations +* **EVE (Taskade Autonomous Agent)** — describe the outcome you want and EVE drafts the automation: trigger, actions, and connected integrations. +* **Workflow Automation Mode** at [taskade.com/create](https://www.taskade.com/create) — a focused chat mode that generates just the workflow from a single prompt. +* Generated flows are normal automations — open them in the flow editor to adjust triggers, actions, and conditions like any hand-built workflow. --- diff --git a/genesis-living-system-builder/automation/integrations.md b/genesis-living-system-builder/automation/integrations.md index a7aaa6a..b43e6b6 100644 --- a/genesis-living-system-builder/automation/integrations.md +++ b/genesis-living-system-builder/automation/integrations.md @@ -91,7 +91,7 @@ Taskade connects to **100+ tools and services** across communication, productivi | **Database** | Record created, updated | Insert record, update data, run query | Connection String | | **FTP/SFTP** | File uploaded, modified | Upload file, download, sync directory | Credentials | -> **Related developer docs:** Build custom integrations programmatically with the [Developer Hub](../../apis-living-system-development/developer-home.md) and [Webhooks](../../apis-living-system-development/webhooks.md). +> **Related developer docs:** Build custom integrations programmatically with the [Developer Hub](../../apis-living-system-development/developer-home.md) and [Webhooks](../../apis-living-system-development/webhooks.md), or contribute to the open-source [Integration Kit](https://github.com/taskade/integrations) (Zapier & n8n actions and triggers). ## Integration Setup @@ -529,7 +529,7 @@ Enterprise customers get priority support for custom integrations. > → [Contact our team](https://taskade.com/contact) for enterprise solutions > **Want to contribute an integration?** -> → [Submit a request](https://taskade.com/community) to our community +> → Open a PR on the open-source [Integration Kit](https://github.com/taskade/integrations) (Zapier & n8n actions and triggers), or [share ideas](https://taskade.com/community) with the community → **Next: [Browse Actions & Triggers](./actions.md)** → **Complete Reference: [Comprehensive Automation Integrations](./comprehensive-integrations.md)** \ No newline at end of file diff --git a/genesis-living-system-builder/community-and-sharing/faq.md b/genesis-living-system-builder/community-and-sharing/faq.md index 097cd91..5c99cdf 100644 --- a/genesis-living-system-builder/community-and-sharing/faq.md +++ b/genesis-living-system-builder/community-and-sharing/faq.md @@ -100,7 +100,7 @@ Every app gets an **individual URL immediately**: ### Can I use my own domain name? -**Coming soon!** You'll be able to use your own branded URL (like `app.yourcompany.com`) instead of the default Genesis link, giving your apps a more professional appearance that matches your brand. +**Yes — custom domains are live.** You can connect your own branded URL (like `app.yourcompany.com`) to a published Genesis app instead of the default Genesis link, giving your apps a professional appearance that matches your brand. ### How do users access my app? diff --git a/help-and-support/index/07_api.md b/help-and-support/index/07_api.md index 316d5ce..4e79adb 100644 --- a/help-and-support/index/07_api.md +++ b/help-and-support/index/07_api.md @@ -134,8 +134,8 @@ Go to Settings → Developer → API Keys → Generate New Key Use curl to retrieve your projects: ``` -curl -H "Authorization: Bearer YOUR_API_KEY" \ - https://api.taskade.com/v1/projects +curl -H "Authorization: Bearer your_api_token_placeholder" \ + https://www.taskade.com/api/v1/projects ``` {% endstep %} @@ -151,10 +151,10 @@ You'll get a JSON array of your projects with full details Try creating a task: ``` -curl -X POST https://api.taskade.com/v1/tasks \ - -H "Authorization: Bearer YOUR_API_KEY" \ +curl -X POST https://www.taskade.com/api/v1/projects/your_project_id/tasks/ \ + -H "Authorization: Bearer your_api_token_placeholder" \ -H "Content-Type: application/json" \ - -d '{"name": "API Test Task", "project_id": "your_project_id"}' + -d '{"tasks": [{"content": "API Test Task", "contentType": "text/markdown", "placement": "beforeend"}]}' ``` {% endstep %} {% endstepper %} @@ -518,29 +518,38 @@ class ResilientAPI { ## SDKs and Development Tools -### Official SDKs +### Call the API from any language -**Pre-built libraries for popular languages:** +The API is standard HTTP + JSON — no SDK required. Authenticate with a personal access token from [taskade.com/settings/api](https://www.taskade.com/settings/api): ```javascript -// JavaScript/TypeScript SDK -import { TaskadeAPI } from '@taskade/sdk'; - -const api = new TaskadeAPI({ - apiKey: 'your_api_key', - baseURL: 'https://api.taskade.com/v1' +// JavaScript/TypeScript — Node.js 18+, Deno, Bun, or the browser +const res = await fetch('https://www.taskade.com/api/v1/workspaces', { + headers: { Authorization: 'Bearer your_api_token_placeholder' }, }); +const data = await res.json(); +``` + +```python +# Python — any HTTP client works +import requests -// Python SDK -from taskade import TaskadeAPI +res = requests.get( + "https://www.taskade.com/api/v1/workspaces", + headers={"Authorization": "Bearer your_api_token_placeholder"}, +) +data = res.json() +``` -api = TaskadeAPI(api_key='your_api_key') +### Official SDKs and tools -# Go SDK -import "github.com/taskade/go-sdk/taskade" +{% hint style="warning" %} +The official TypeScript SDK (`@taskade/sdk`) is in preview and **not yet published to the public npm registry**. Until it ships, use the REST API directly as shown above. +{% endhint %} -api := taskade.NewAPI("your_api_key") -``` +* [**TypeScript SDK (Preview)**](../../apis-living-system-development/sdk-quickstart.md) — generated client for API v2; the quickstart shows the HTTP-first path you can use today +* [**Workspace MCP Server**](https://github.com/taskade/mcp) — `@taskade/mcp-server` on npm; connect Claude Desktop, Cursor, and any MCP client to your workspace +* [**Integration Kit**](https://github.com/taskade/integrations) — open-source Zapier and n8n actions & triggers built on this public API ### Development Tools diff --git a/updates-and-timeline/changelog-2026/README.md b/updates-and-timeline/changelog-2026/README.md index 488714d..23ab75b 100644 --- a/updates-and-timeline/changelog-2026/README.md +++ b/updates-and-timeline/changelog-2026/README.md @@ -1,3 +1,7 @@ # Changelog (2026) Product updates, new features, and improvements shipped in 2026. For releases before 2026, see the [Changelog archive](../../changelog/README.md). + +{% hint style="info" %} +This section highlights major releases. For the complete, always-current stream of updates, see [taskade.com/changelog](https://www.taskade.com/changelog). +{% endhint %} diff --git a/updates-and-timeline/changelog-2026/april-2026/april-8-2026.md b/updates-and-timeline/changelog-2026/april-2026/april-8-2026.md index f72e085..011f8bf 100644 --- a/updates-and-timeline/changelog-2026/april-2026/april-8-2026.md +++ b/updates-and-timeline/changelog-2026/april-2026/april-8-2026.md @@ -12,7 +12,7 @@ Taskade now runs an MCP server that lets external AI tools — like Claude Deskt ### Taskade SDK -The official Taskade SDK is here. TypeScript-first, auto-generated from the API schema, and installable via `yarn add @taskade/sdk`. Build integrations faster with typed methods for every endpoint. +The official Taskade SDK is here in preview. TypeScript-first and auto-generated from the API schema, with typed methods for every endpoint. The public npm release is in progress — see the [SDK Quickstart](../../../apis-living-system-development/sdk-quickstart.md) for the HTTP-first path you can use today. *** From 9e97f68e57695cb4b4ddca3be7b47fcc71f965fb Mon Sep 17 00:00:00 2001 From: johnxie Date: Tue, 9 Jun 2026 20:28:35 -0700 Subject: [PATCH 2/2] fix(07_api): list-projects endpoint is GET /v1/me/projects, not /v1/projects Review caught that GET /projects does not exist in the v1 spec (live: 404); the real list-your-projects route is /me/projects (live: 401 on fake token, i.e. real route). POST /projects (create) is unaffected. --- help-and-support/index/07_api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/help-and-support/index/07_api.md b/help-and-support/index/07_api.md index 4e79adb..fd2553f 100644 --- a/help-and-support/index/07_api.md +++ b/help-and-support/index/07_api.md @@ -135,7 +135,7 @@ Use curl to retrieve your projects: ``` curl -H "Authorization: Bearer your_api_token_placeholder" \ - https://www.taskade.com/api/v1/projects + https://www.taskade.com/api/v1/me/projects ``` {% endstep %}