{"openapi":"3.0.3","info":{"title":"Taskade Public API (v1)","description":"Taskade REST API (v1, GA) \u2014 stable, resource-style endpoints with full task and project CRUD. The AI-native workspace platform: build apps, deploy agents, automate workflows.","version":"1.0.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\u2019s 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":{"displayName":{"type":"string","minLength":1},"type":{"type":"string","enum":["Rating"]},"max":{"type":"integer","minimum":1,"maximum":10,"default":5},"icon":{"type":"string","enum":["star","heart"],"default":"star"}},"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},{"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":["Media"]},"title":{"type":"string"},"description":{"type":"string"}},"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-fable-5","anthropic\/claude-fable-5: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-5","anthropic\/claude-sonnet-5: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","zai\/glm-5.2"]}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["moonshotai"]},"name":{"type":"string","enum":["moonshotai\/kimi-k2.6","moonshotai\/kimi-k2.7-code"]}},"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","Designer","Brainstormer","Builder","ResearchAnalyst","OperationsManager","CodeReviewer","LeadScorer","ContactEnricher","ContentStrategist","DealMover","Estimator","DigitalTwin","WatchFloorBriefer","AnomalySpotter","RestockAdvisor","AppDoctor","RenewalChaser","WinBackSpecialist","NoShowRescuer","AbandonedCartRecoverer","ReviewResponder","TestimonialHarvester","SponsorshipManager","CourseLaunchStrategist","CurriculumAuthor","PersonalizedRoadmapGenerator","DispatchCoordinator","ProviderNetworkBuilder","ClaimsClerk","ListingMarketer","GrantWriter","ComplianceKeeper","LeadQualifier","ClientOnboardingConcierge","PipelineReporter","LearnerCoach"]},"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},"color":{"type":"string"},"launcherIcon":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"value":{"type":"string","minLength":1}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"image":{"$ref":"#\/properties\/item\/properties\/data\/properties\/avatar\/anyOf\/0\/properties\/data\/properties\/file"}},"required":["type","image"],"additionalProperties":false}],"nullable":true}},"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},"color":{"type":"string"},"launcherIcon":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"value":{"type":"string","minLength":1}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"image":{"$ref":"#\/properties\/preferences\/properties\/meta\/properties\/image"}},"required":["type","image"],"additionalProperties":false}],"nullable":true}},"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},"color":{"type":"string"},"launcherIcon":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"value":{"type":"string","minLength":1}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"image":{"$ref":"#\/properties\/item\/properties\/data\/properties\/avatar\/anyOf\/0\/properties\/data\/properties\/file"}},"required":["type","image"],"additionalProperties":false}],"nullable":true}},"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 \u2014 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 \u2014 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 \u2014 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},"color":{"type":"string"},"launcherIcon":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["emoji"]},"value":{"type":"string","minLength":1}},"required":["type","value"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["custom"]},"image":{"$ref":"#\/properties\/item\/properties\/data\/properties\/avatar\/anyOf\/0\/properties\/data\/properties\/file"}},"required":["type","image"],"additionalProperties":false}],"nullable":true}},"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":[]}]}