{"success":true,"data":{"endpoints":[{"key":"get-countries","title":"Get countries","description":"Get all countries","group":"Country","method":"GET","path":"/countries","requiresAuthentication":false,"oauthScopes":[],"mcp":{"toolName":"Get_countries","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"isDeleted":{"type":"boolean"},"name":{"type":"string"},"dialCode":{"type":"string"},"code":{"type":"string"},"exampleTaxId":{"type":"string"}},"required":["id","createdAt","updatedAt","deletedAt","isDeleted","name","dialCode","code","exampleTaxId"],"additionalProperties":false}}},"required":["countries"],"additionalProperties":false}}},{"key":"get-company-by-tax-id","title":"Get company by tax ID","description":"Lookup company details by country code and tax ID","group":"Company","method":"GET","path":"/company/by-tax-id","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":{"type":"object","properties":{"countryCode":{"type":"string","minLength":2},"taxId":{"type":"string","minLength":1}},"required":["countryCode","taxId"],"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"company":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"isDeleted":{"type":"boolean"},"countryCode":{"type":"string"},"taxId":{"type":"string"},"companyName":{"type":"string"},"contactPersonName":{"type":["string","null"]},"streetLine1":{"type":"string"},"streetLine2":{"type":["string","null"]},"city":{"type":"string"},"postalCode":{"type":"string"},"stateOrProvince":{"type":["string","null"]}},"required":["id","createdAt","updatedAt","deletedAt","isDeleted","countryCode","taxId","companyName","contactPersonName","streetLine1","streetLine2","city","postalCode","stateOrProvince"],"additionalProperties":false},{"type":"null"}]},"isFromCache":{"type":"boolean"},"normalizedTaxId":{"type":["string","null"]}},"required":["company","isFromCache","normalizedTaxId"],"additionalProperties":false}}},{"key":"get-workspace-by-name","title":"Get workspace by name","description":"Get a workspace by its name","group":"Workspace","method":"GET","path":"/workspace/:workspaceName","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_by_name","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceName":{"type":"string"}},"required":["workspaceName"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"dateFormat":{"type":"string"},"completedLogoFileVariants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileId":{"type":"string"},"variant":{"type":"string"},"url":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"size":{"type":"number"},"mimeType":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","fileId","variant","url","mimeType","createdAt","updatedAt"],"additionalProperties":false}},"employeeRange":{"anyOf":[{"type":"string","enum":["1-5","6-10","11-50","51-100","101-250","251-500","501-1000","1000+"]},{"type":"null"}]},"teamRange":{"anyOf":[{"type":"string","enum":["just-me","2-5","6-10","11-20","21-50","51-100","100+"]},{"type":"null"}]},"coreAreas":{"type":"array","items":{"type":"string","enum":["sales","marketing","customer-support","finance","operations","hr-and-recruitment","supply-chain","product-development","project-management","legal","software-development","manufacturing","procurement","education"]}},"solutions":{"type":"array","items":{"type":"string","enum":["task-and-project-management","knowledge-center","crm","team-collaboration-tools","it-support-desk","data-integration","marketing-automation","ai-powered-tools"]}},"skippedOnboardingSteps":{"type":"array","items":{"type":"string","enum":["workspace-customization","company-info","core-areas","solutions","invite","role-and-discover","generate-workspace","profile-customization"]}},"pendingOnboardingPlan":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","enum":["ai","template","empty"]},"templateId":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"groupName":{"type":"string"},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"name":{"type":"string"}},"required":["resourceType","iconNameType","name"],"additionalProperties":false}}},"required":["groupName","resources"],"additionalProperties":false}}},"required":["source","groups"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","name","dateFormat","completedLogoFileVariants","employeeRange","teamRange","coreAreas","solutions","skippedOnboardingSteps","pendingOnboardingPlan"],"additionalProperties":false}},"required":["workspace"],"additionalProperties":false}}},{"key":"create-workspace","title":"Create workspace","description":"Create a new workspace","group":"Workspace","method":"POST","path":"/workspace","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_workspace","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"name":{"type":"string","minLength":3,"maxLength":32},"type":{"type":"string","enum":["private","team"]}},"required":["title","name","type"],"additionalProperties":false},"response":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"dateFormat":{"type":"string"},"completedLogoFileVariants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileId":{"type":"string"},"variant":{"type":"string"},"url":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"size":{"type":"number"},"mimeType":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","fileId","variant","url","mimeType","createdAt","updatedAt"],"additionalProperties":false}},"employeeRange":{"anyOf":[{"type":"string","enum":["1-5","6-10","11-50","51-100","101-250","251-500","501-1000","1000+"]},{"type":"null"}]},"teamRange":{"anyOf":[{"type":"string","enum":["just-me","2-5","6-10","11-20","21-50","51-100","100+"]},{"type":"null"}]},"coreAreas":{"type":"array","items":{"type":"string","enum":["sales","marketing","customer-support","finance","operations","hr-and-recruitment","supply-chain","product-development","project-management","legal","software-development","manufacturing","procurement","education"]}},"solutions":{"type":"array","items":{"type":"string","enum":["task-and-project-management","knowledge-center","crm","team-collaboration-tools","it-support-desk","data-integration","marketing-automation","ai-powered-tools"]}},"skippedOnboardingSteps":{"type":"array","items":{"type":"string","enum":["workspace-customization","company-info","core-areas","solutions","invite","role-and-discover","generate-workspace","profile-customization"]}},"pendingOnboardingPlan":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","enum":["ai","template","empty"]},"templateId":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"groupName":{"type":"string"},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"name":{"type":"string"}},"required":["resourceType","iconNameType","name"],"additionalProperties":false}}},"required":["groupName","resources"],"additionalProperties":false}}},"required":["source","groups"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","name","dateFormat","completedLogoFileVariants","employeeRange","teamRange","coreAreas","solutions","skippedOnboardingSteps","pendingOnboardingPlan"],"additionalProperties":false}},"required":["workspace"],"additionalProperties":false}}},{"key":"update-workspace","title":"Update workspace","description":"Update an existing workspace","group":"Workspace","method":"PATCH","path":"/workspace/:workspaceId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"name":{"type":"string","minLength":3,"maxLength":32},"type":{"type":"string","enum":["private","team"]},"dateFormat":{"type":"string","enum":["workspace","dd/MM/yyyy","MM/dd/yyyy","yyyy-MM-dd","dd-MM-yyyy","yyyy/MM/dd","MM/yyyy","yyyy-MM","MMM yyyy","d MMM, yyyy","MMMM d, yyyy","MMM dd, yyyy","MMMM dd, yyyy","EEE, d MMM yyyy","EEEE, MMMM d, yyyy","EEE, MMM dd, yyyy","EEEE, d","EEE, d","yyyyMMdd","EEEE","EEE","EEEE, MMMM","EEE, MMM","EEEE, MMMM d","EEE, MMM d"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-workspace","title":"Delete workspace","description":"Delete a workspace","group":"Workspace","method":"DELETE","path":"/workspace/:workspaceId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-workspace-logo","title":"Update workspace logo","description":"Update workspace logo (file upload not supported in MCP)","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/logo","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"dateFormat":{"type":"string"},"completedLogoFileVariants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileId":{"type":"string"},"variant":{"type":"string"},"url":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"size":{"type":"number"},"mimeType":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","fileId","variant","url","mimeType","createdAt","updatedAt"],"additionalProperties":false}},"employeeRange":{"anyOf":[{"type":"string","enum":["1-5","6-10","11-50","51-100","101-250","251-500","501-1000","1000+"]},{"type":"null"}]},"teamRange":{"anyOf":[{"type":"string","enum":["just-me","2-5","6-10","11-20","21-50","51-100","100+"]},{"type":"null"}]},"coreAreas":{"type":"array","items":{"type":"string","enum":["sales","marketing","customer-support","finance","operations","hr-and-recruitment","supply-chain","product-development","project-management","legal","software-development","manufacturing","procurement","education"]}},"solutions":{"type":"array","items":{"type":"string","enum":["task-and-project-management","knowledge-center","crm","team-collaboration-tools","it-support-desk","data-integration","marketing-automation","ai-powered-tools"]}},"skippedOnboardingSteps":{"type":"array","items":{"type":"string","enum":["workspace-customization","company-info","core-areas","solutions","invite","role-and-discover","generate-workspace","profile-customization"]}},"pendingOnboardingPlan":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","enum":["ai","template","empty"]},"templateId":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"groupName":{"type":"string"},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"name":{"type":"string"}},"required":["resourceType","iconNameType","name"],"additionalProperties":false}}},"required":["groupName","resources"],"additionalProperties":false}}},"required":["source","groups"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","name","dateFormat","completedLogoFileVariants","employeeRange","teamRange","coreAreas","solutions","skippedOnboardingSteps","pendingOnboardingPlan"],"additionalProperties":false}},"required":["workspace"],"additionalProperties":false}}},{"key":"get-workspace-usage","title":"Get workspace usage summary","description":"Returns aggregated billing usage for a workspace (totals, per-day, per-service, per-entity) within an optional date range.","group":"Workspace","method":"GET","path":"/workspace/:workspaceId/usage","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_usage_summary","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"totalNanoAmount":{"type":"number"},"currency":{"type":["string","null"]},"eventCount":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"tokenCount":{"type":"number"},"totalNanoAmount":{"type":"number"},"currency":{"type":["string","null"]}},"required":["date","tokenCount","totalNanoAmount","currency"],"additionalProperties":false}},"uniqueEntities":{"type":"array","items":{"type":"object","properties":{"entity":{},"totalNanoAmount":{"type":"number"},"currency":{"type":["string","null"]},"breakdown":{"type":"array","items":{"type":"object","properties":{"serviceType":{"type":"string"},"totalNanoAmount":{"type":"number"},"currency":{"type":["string","null"]}},"required":["serviceType","totalNanoAmount","currency"],"additionalProperties":false}}},"required":["totalNanoAmount","currency","breakdown"],"additionalProperties":false}},"services":{"type":"array","items":{"type":"object","properties":{"serviceType":{"type":"string"},"totalNanoAmount":{"type":"number"},"currency":{"type":["string","null"]},"units":{"type":"array","items":{"type":"object","properties":{"unit":{"type":"string"},"quantity":{"type":"number"}},"required":["unit","quantity"],"additionalProperties":false}}},"required":["serviceType","totalNanoAmount","currency","units"],"additionalProperties":false}}},"required":["totalNanoAmount","currency","eventCount","days","uniqueEntities","services"],"additionalProperties":false}}},{"key":"get-workspace-usage-events","title":"Get workspace usage events","description":"Returns paginated raw usage events for a workspace within an optional date range.","group":"Workspace","method":"GET","path":"/workspace/:workspaceId/usage-events","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_usage_events","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["offset","limit"],"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"usageEvents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"actorEntity":{"anyOf":[{},{"type":"null"}]},"actorEntityType":{"type":["string","null"]},"actorEntityId":{"type":["string","null"]},"provider":{"type":"string"},"serviceType":{"type":"string"},"modelKey":{"type":"string"},"operationKey":{"type":["string","null"]},"status":{"type":"string"},"requestId":{"type":["string","null"]},"currency":{"type":["string","null"]},"totalNanoAmount":{"type":["number","null"]},"lineItems":{"type":"array","items":{"type":"object","properties":{"unit":{"type":"string"},"quantity":{"type":"number"},"pricePerUnitNanoAmount":{"type":["number","null"]},"totalNanoAmount":{"type":["number","null"]},"currency":{"type":["string","null"]},"providerUsagePriceId":{"type":["string","null"]}},"required":["unit","quantity"],"additionalProperties":false}},"callId":{"type":["string","null"]},"messageId":{"type":["string","null"]},"conversationType":{"type":["string","null"]},"conversationPayload":{},"metadata":{},"error":{"type":["string","null"]},"occurredAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","actorEntityType","actorEntityId","provider","serviceType","modelKey","status","lineItems","occurredAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["usageEvents","hasMore"],"additionalProperties":false}}},{"key":"export-template","title":"Export workspace template","description":"Build template documents from selected resources in a workspace (databases, dashboards, folders, resource groups). Returns the template payloads — does not persist anything.","group":"Workspace","method":"POST","path":"/workspace/:workspaceId/export-template","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Export_workspace_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false}},"excludedResources":{"type":"array","items":{"$ref":"#/properties/resources/items"}},"excludedResourceTypes":{"type":"array","items":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}}},"required":["resources"],"additionalProperties":false},"response":{"type":"object","properties":{"templates":{"type":"array"}},"required":["templates"],"additionalProperties":false}}},{"key":"get-resource-tree","title":"Get resource tree","description":"Build a hierarchical tree of all readable resources in a workspace (workspace → spaces → folders/databases → views, etc.). Skips resources the requesting entity has no read access to. Excludes DatabaseItem nodes.","group":"Workspace","method":"GET","path":"/workspace/:workspaceId/resource-tree","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_resource_tree","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"tree":{}},"additionalProperties":false}}},{"key":"import-template","title":"Import workspace template","description":"Create resources from template payloads under a target Database or ResourceGroup. Strategy hooks enrich each parent template with location info before extraction.","group":"Workspace","method":"POST","path":"/workspace/:workspaceId/import-template","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Import_workspace_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"templates":{"type":"array"},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"importId":{"type":"string"}},"required":["templates","targetResourceType","targetResourceId"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-workspace-onboarding-company-info","title":"Update workspace onboarding company info","description":"Save employee range and team range for the onboarding company info step.","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/onboarding/company-info","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"employeeRange":{"type":"string","enum":["1-5","6-10","11-50","51-100","101-250","251-500","501-1000","1000+"]},"teamRange":{"type":"string","enum":["just-me","2-5","6-10","11-20","21-50","51-100","100+"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-workspace-onboarding-core-areas","title":"Update workspace onboarding core areas","description":"Save the list of core areas (max 5) for the onboarding step.","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/onboarding/core-areas","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"coreAreas":{"type":"array","items":{"type":"string","enum":["sales","marketing","customer-support","finance","operations","hr-and-recruitment","supply-chain","product-development","project-management","legal","software-development","manufacturing","procurement","education"]},"maxItems":5}},"required":["coreAreas"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-workspace-onboarding-solutions","title":"Update workspace onboarding solutions","description":"Save the list of solutions for the onboarding step.","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/onboarding/solutions","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"solutions":{"type":"array","items":{"type":"string","enum":["task-and-project-management","knowledge-center","crm","team-collaboration-tools","it-support-desk","data-integration","marketing-automation","ai-powered-tools"]}}},"required":["solutions"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"generate-workspace-onboarding-plan","title":"Generate workspace onboarding plan","description":"Ask the model for a starter resource list from the onboarding prompt.","group":"Workspace","method":"POST","path":"/workspace/:workspaceId/onboarding/generate-plan","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","maxLength":2000},"locale":{"type":"string","enum":["pl","en","de","ua","fr","es","it","pt","nl","sv","no","da","fi","el","tr","ja","zh","ko","ar"]}},"required":["prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"groupName":{"type":"string"},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"name":{"type":"string"}},"required":["resourceType","iconNameType","name"],"additionalProperties":false},"maxItems":10}},"required":["groupName","resources"],"additionalProperties":false},"maxItems":12}},"required":["groups"],"additionalProperties":false}}},{"key":"update-workspace-onboarding-plan","title":"Save workspace onboarding plan","description":"Persist the AI, template, or empty starter choice for the generate-workspace step.","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/onboarding/workspace-plan","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"source":{"type":"string","enum":["ai","template","empty"]},"templateId":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"groupName":{"type":"string","minLength":1,"maxLength":80},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"name":{"type":"string","minLength":1,"maxLength":80}},"required":["resourceType","iconNameType","name"],"additionalProperties":false},"maxItems":10}},"required":["groupName","resources"],"additionalProperties":false},"maxItems":12}},"required":["source"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"skip-workspace-onboarding-step","title":"Skip workspace onboarding step","description":"Mark a workspace-level onboarding step as skipped.","group":"Workspace","method":"PUT","path":"/workspace/:workspaceId/onboarding/skip/:onboardingStepType","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"onboardingStepType":{"type":"string","enum":["workspace-customization","company-info","core-areas","solutions","invite","role-and-discover","generate-workspace","profile-customization"]}},"required":["workspaceId","onboardingStepType"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"save-template","title":"Save workspace template","description":"Build template documents from selected resources and persist them as a reusable template under the workspace.","group":"Workspace","method":"POST","path":"/workspace/:workspaceId/templates","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Save_workspace_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20},"templateId":{"type":"string"},"visibility":{"type":"string","enum":["everyone","members-and-admins","admins-only","only-me"]},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"minItems":1},"excludedResources":{"type":"array","items":{"$ref":"#/properties/resources/items"}},"excludedResourceTypes":{"type":"array","items":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}}},"required":["name","resources"],"additionalProperties":false},"response":{"type":"object","properties":{"template":{}},"additionalProperties":false}}},{"key":"get-templates","title":"List workspace templates","description":"Return saved templates for a workspace. Templates are ordered newest-first and contain only summary metadata (id, name, description, timestamps).","group":"Workspace","method":"GET","path":"/workspace/:workspaceId/templates","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_workspace_templates","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"isBuiltIn":{"type":"boolean"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"isGeneratedByAi":{"type":"boolean"},"isDeletable":{"type":"boolean"},"databasesCount":{"type":"number"},"propertiesCount":{"type":"number"},"viewsCount":{"type":"number"},"itemsCount":{"type":"number"},"whiteboardsCount":{"type":"number"},"documentsCount":{"type":"number"},"simpleResourceCounts":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"count":{"type":"number"}},"required":["resourceType","count"],"additionalProperties":false}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}}},"required":["id","name","createdAt","updatedAt","isBuiltIn","isGeneratedByAi","isDeletable","databasesCount","propertiesCount","viewsCount","itemsCount","whiteboardsCount","documentsCount","simpleResourceCounts","resourceTypes"],"additionalProperties":false}}},"required":["templates"],"additionalProperties":false}}},{"key":"get-template-detail","title":"Get workspace template detail","description":"Return a single template (built-in or saved) with its full resource structure.","group":"Workspace","method":"GET","path":"/workspace/:workspaceId/templates/:templateId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_template_detail","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"templateId":{"type":"string"}},"required":["workspaceId","templateId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"template":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"isBuiltIn":{"type":"boolean"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"isGeneratedByAi":{"type":"boolean"},"isDeletable":{"type":"boolean"},"databasesCount":{"type":"number"},"propertiesCount":{"type":"number"},"viewsCount":{"type":"number"},"itemsCount":{"type":"number"},"whiteboardsCount":{"type":"number"},"documentsCount":{"type":"number"},"simpleResourceCounts":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"count":{"type":"number"}},"required":["resourceType","count"],"additionalProperties":false}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"detailedDescription":{"type":"string"},"templateData":{"type":"array","items":{}}},"required":["id","name","createdAt","updatedAt","isBuiltIn","isGeneratedByAi","isDeletable","databasesCount","propertiesCount","viewsCount","itemsCount","whiteboardsCount","documentsCount","simpleResourceCounts","resourceTypes","templateData"],"additionalProperties":false}},"required":["template"],"additionalProperties":false}}},{"key":"generate-template","title":"Generate a workspace template with AI","description":"Ask the model for a template matching the prompt. The template is saved among the workspace templates (marked as generated by AI) without creating any resource; the result can be imported with `import-template`.","group":"Workspace","method":"POST","path":"/workspace/:workspaceId/templates/generate","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":3,"maxLength":2000},"resourceTypes":{"type":"array","items":{"type":"string","enum":["database","document","whiteboard","conversation","call-room","dashboard","folder","automation","app","skill","agent"]},"minItems":1},"locale":{"type":"string","enum":["pl","en","de","ua","fr","es","it","pt","nl","sv","no","da","fi","el","tr","ja","zh","ko","ar"]}},"required":["prompt","resourceTypes"],"additionalProperties":false},"response":{"type":"object","properties":{"template":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"isBuiltIn":{"type":"boolean"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"isGeneratedByAi":{"type":"boolean"},"isDeletable":{"type":"boolean"},"databasesCount":{"type":"number"},"propertiesCount":{"type":"number"},"viewsCount":{"type":"number"},"itemsCount":{"type":"number"},"whiteboardsCount":{"type":"number"},"documentsCount":{"type":"number"},"simpleResourceCounts":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"count":{"type":"number"}},"required":["resourceType","count"],"additionalProperties":false}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"detailedDescription":{"type":"string"},"templateData":{"type":"array","items":{}}},"required":["id","name","createdAt","updatedAt","isBuiltIn","isGeneratedByAi","isDeletable","databasesCount","propertiesCount","viewsCount","itemsCount","whiteboardsCount","documentsCount","simpleResourceCounts","resourceTypes","templateData"],"additionalProperties":false}},"required":["template"],"additionalProperties":false}}},{"key":"delete-template","title":"Delete workspace template","description":"Delete a template saved in this workspace. Only its author or a workspace admin may do so.","group":"Workspace","method":"DELETE","path":"/workspace/:workspaceId/templates/:templateId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_workspace_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"templateId":{"type":"string"}},"required":["workspaceId","templateId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"templateId":{"type":"string"}},"required":["templateId"],"additionalProperties":false}}},{"key":"get-database","title":"Get database","description":"Get a database by its ID","group":"Database","method":"GET","path":"/database/:databaseId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}},{"key":"get-databases","title":"Get databases","description":"Get all databases in a workspace","group":"Database","method":"GET","path":"/workspace/:workspaceId/databases","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_databases","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}}},"required":["databases"],"additionalProperties":false}}},{"key":"get-databases-with-property","title":"Get databases with property","description":"Get all databases in a workspace filtered by property value type","group":"Database","method":"GET","path":"/workspace/:workspaceId/databases-with-property","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_databases_with_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"propertyValueType":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"databases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}}},"required":["databases"],"additionalProperties":false}}},{"key":"create-database","title":"Create database","description":"Create a new database in a workspace","group":"Database","method":"POST","path":"/workspace/:workspaceId/database","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","minLength":1},"description":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"isPublic":{"type":"boolean"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}},{"key":"create-database-by-template","title":"Create database by template","description":"Create a new database from a template","group":"Database","method":"POST","path":"/workspace/:workspaceId/database-by-template","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database_by_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","minLength":1},"templateType":{"type":"string","enum":["empty","items","employees","tasks","marketing-campaign","sales-pipeline","lead-tracker","inventory-management","vendor-management","product-roadmap","feature-requests","project-tracker","sprint-planning","expense-tracker","invoice-management","budget-planning","recruitment-pipeline","performance-reviews","support-tickets","knowledge-base","bug-tracker","code-review","design-projects","asset-library","content-calendar","blog-posts","course-management","student-progress","shipment-tracker","warehouse-management","property-listings","construction-projects","startup-tracker","investor-relations","example-resource"]},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]}},"required":["title","templateType"],"additionalProperties":false},"response":{"type":"object","properties":{"databases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}}},"required":["databases"],"additionalProperties":false}}},{"key":"create-database-by-prompt","title":"Create database by prompt","description":"Create a new database from an AI prompt","group":"Database","method":"POST","path":"/workspace/:workspaceId/database-by-prompt","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database_by_prompt","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","minLength":1},"prompt":{"type":"string","minLength":1}},"required":["title","prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"databases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}}},"required":["databases"],"additionalProperties":false}}},{"key":"update-database","title":"Update database","description":"Update a database","group":"Database","method":"PUT","path":"/database/:databaseId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"namePropertyId":{"type":"string"},"primaryStatusPropertyId":{"type":["string","null"]},"primaryPeoplePropertyId":{"type":["string","null"]},"primaryDatePropertyId":{"type":["string","null"]},"itemName":{},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]}},"additionalProperties":false},"response":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"createdAt":{"type":"string"},"coverFile":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"size":{"type":"number"},"mimeType":{"type":"string"},"commonFileType":{"type":"string"},"variants":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"originalName":{"type":"string"}},"required":["id","url","size","mimeType","commonFileType","variants","originalName"],"additionalProperties":false},{"type":"null"}]},"namePropertyId":{"type":"string"},"defaultDatabaseViewId":{"type":"string"}},"required":["id","title","description","createdAt","coverFile","defaultDatabaseViewId"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}},{"key":"delete-database","title":"Delete database","description":"Delete or archive a database","group":"Database","method":"DELETE","path":"/database/:databaseId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"force":{"type":"boolean"}},"additionalProperties":false},"response":{"anyOf":[{"type":"object","properties":{},"additionalProperties":false},{"type":"null"}]}}},{"key":"unarchive-database","title":"Unarchive database","description":"Unarchive a previously archived database","group":"Database","method":"POST","path":"/database/:databaseId/unarchive","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Unarchive_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":null,"response":{"anyOf":[{"type":"object","properties":{},"additionalProperties":false},{"type":"null"}]}}},{"key":"generate-filter-by-prompt","title":"Generate filter by prompt","description":"Generate a database filter from an AI prompt","group":"Database","method":"POST","path":"/database/:databaseId/filter-by-prompt","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_filter_by_prompt","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":1}},"required":["prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"filter":{"anyOf":[{},{"type":"null"}]}},"additionalProperties":false}}},{"key":"export-database","title":"Export database","description":"Export a database to a file","group":"Database","method":"POST","path":"/database/:databaseId/exportDatabase","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Export_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"exportType":{"type":"string","enum":["csv","xlsx","json"]},"filterQuery":{}},"required":["exportType"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"convert-file-to-suggested-data","title":"Convert file to suggested data","description":"Convert a file to suggested database data","group":"Database","method":"POST","path":"/database/convert-file-to-data","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Convert_file_to_suggested_data","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"existingDatabaseId":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"import-database","title":"Import database","description":"Import data into a database from a file","group":"Database","method":"POST","path":"/database/:databaseId/import","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Import_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"convertedFileData":{"type":"array","items":{}},"fileId":{"type":"string"}},"required":["convertedFileData","fileId"],"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"get-database-templates","title":"Get database templates","description":"List the predefined database templates a user can choose from when creating a database. Localized titles based on user locale.","group":"Database","method":"GET","path":"/workspace/:workspaceId/database-templates","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_templates","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"templates":{"type":"array"}},"required":["templates"],"additionalProperties":false}}},{"key":"duplicate-database","title":"Duplicate database","description":"Schedule a background job that duplicates a database (with all properties and items) into the same workspace. Returns a jobId — poll the job status to know when the duplicate is ready.","group":"Database","method":"POST","path":"/database/:databaseId/duplicate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Duplicate_database","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"generate-formula-by-prompt","title":"Generate formula by prompt","description":"Use the AI service to translate a natural-language prompt into a database formula expression. Returns the expression string only — does not persist anything.","group":"Database","method":"POST","path":"/database/:databaseId/formula-by-prompt","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_formula_by_prompt","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":1}},"required":["prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"expression":{"type":"string"}},"required":["expression"],"additionalProperties":false}}},{"key":"create-database-item","title":"Create database item","description":"Create a new item in a database.\nUse this to create exactly one database item.\nBefore every create, ALWAYS call get_database_properties for the target database in the same turn.\nPrefer sending only params.databaseId plus body.cellValues and optionally body.state.\nbody.cellValues keys must be database property IDs, not labels or names.\nBuild body.cellValues from the latest properties[].id and properties[].exampleCellValue returned by get_database_properties.\nFor constrained fields like status or dropdown, use the exact allowed IDs from the property metadata. Never send visible labels unless the example says so.\nWhen unsure what a property accepts, call get_database_property_possible_values for it: enumerable types (status, dropdown) return the full list of allowed IDs, every other type returns the exact example shape to send.","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string","description":"ID of the database where the item should be created."}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"output":{"type":"string"}},"additionalProperties":false},"body":{"type":"object","properties":{"cellValues":{"type":"object","additionalProperties":{},"description":"Cell values mapped by database property ID. Use property IDs as keys, not labels. Before creating an item, always call get_database_properties and build this object from properties[].id and properties[].exampleCellValue. Do not guess the shape. For constrained fields such as status or dropdown, use exact allowed option IDs rather than visible labels."},"state":{"type":"string","enum":["archived","published","pending-submission","draft"],"description":"Optional item state, published by default. Anything other than published creates an item that stays hidden from every view, so only use it for the app flows that publish it later."},"filter":{"description":"Advanced optional server-side filter context used by the app in special flows. Usually omit this when creating items through AI tools."},"search":{"type":["string","null"],"description":"Advanced optional search context used by the app in special flows. Usually omit this when creating items through AI tools."},"requestId":{"type":"string","description":"Optional client-generated request id, echoed back on the DatabaseItemCreated event so the client can correlate its optimistic create with the server broadcast."}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"}},"required":["valueType"],"additionalProperties":false}},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","cellValues","state","createdAt"],"additionalProperties":false}},"required":["databaseItem"],"additionalProperties":false}}},{"key":"create-database-items","title":"Create multiple database items","description":"Create multiple items in a database in a single request. Runs asynchronously and returns a jobId.","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items/create","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_multiple_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"cellValues":{"type":"object","additionalProperties":{}}},"additionalProperties":false},"minItems":1},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"filter":{},"search":{"type":["string","null"]}},"required":["items"],"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"get-or-create-database-item-draft","title":"Get or create a database item draft","description":"Return the unfinished draft item of the current entity for this database, creating one when none exists","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/item-draft","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string","description":"ID of the database the draft belongs to."}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"output":{"type":"string"}},"additionalProperties":false},"body":{"type":"object","properties":{"cellValues":{"type":"object","additionalProperties":{},"description":"Cell values applied only when a new draft has to be created, mapped by database property ID."},"filter":{"description":"Filter context of the view the draft is started from, so the created draft already matches it."}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"},"statusGroupType":{"type":"string"}},"required":["valueType"],"additionalProperties":false}},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","name","cellValues","state","createdAt"],"additionalProperties":false},"wasCreated":{"type":"boolean"}},"required":["databaseItem","wasCreated"],"additionalProperties":false}}},{"key":"get-database-item","title":"Get database item","description":"Get a single database item by its ID","group":"DatabaseItem","method":"GET","path":"/item/:databaseItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":{"type":"object","properties":{"includeWatcherInfo":{"type":"string","enum":["true","false"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"databaseItem":{"type":"object","properties":{"id":{"type":"string"},"databaseId":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"},"statusGroupType":{"type":"string"}},"required":["valueType"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"isWatchedByCurrentUser":{"type":"boolean"}},"required":["id","databaseId","name","state","cellValues","createdAt"],"additionalProperties":false}},"required":["databaseItem"],"additionalProperties":false}}},{"key":"get-database-items","title":"Get database items","description":"Get multiple database items from a database with filtering and pagination","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"sort":{"type":["string","null"]},"sortDirection":{"anyOf":[{"type":"string","enum":["1","-1"]},{"type":"null"}]},"compact":{"type":["boolean","string"]},"offset":{"type":"number"},"limit":{"type":"number"},"search":{"type":["string","null"]},"itemIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"body":{"type":"object","properties":{"filter":{},"databasePropertyIds":{"type":"array","items":{"type":"string"}},"searchScope":{"type":"string","enum":["all","filtered"]}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"}},"required":["valueType"],"additionalProperties":false}}},"required":["id","name","state","cellValues"],"additionalProperties":false}}},"required":["databaseItems"],"additionalProperties":false}}},{"key":"get-items-by-filter-groups","title":"Get items by filter groups","description":"Get database items grouped by multiple filters","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items/filter-groups","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_items_by_filter_groups","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"sort":{"type":["string","null"]},"sortDirection":{"anyOf":[{"type":"string","enum":["1","-1"]},{"type":"null"}]},"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"filterGroups":{"type":"array","items":{"type":"object","properties":{"filter":{},"offset":{"type":"number"},"limit":{"type":"number"}},"additionalProperties":false}},"databasePropertyIds":{"type":"array","items":{"type":"string"}}},"required":["filterGroups"],"additionalProperties":false},"response":{"type":"object","properties":{"databaseItemsGroups":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"}},"required":["valueType"],"additionalProperties":false}}},"required":["id","name","cellValues"],"additionalProperties":false}}}},"required":["databaseItemsGroups"],"additionalProperties":false}}},{"key":"get-database-trash-items","title":"Get database trash items","description":"Get soft-deleted items of a database that can still be restored","group":"DatabaseItem","method":"GET","path":"/database/:databaseId/trash-items","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"offset":{"type":"number","minimum":0,"default":0},"limit":{"type":"number","minimum":1,"maximum":100,"default":50},"search":{"type":"string"},"deletedFrom":{"type":"string","format":"date-time"},"deletedTo":{"type":"string","format":"date-time"},"deletedByEntityIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"databaseItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"deletedAt":{"type":"string","format":"date-time"},"deletedBy":{"type":"object","properties":{"entityType":{"type":"string","enum":["bot","user","system","guest","app","agent"]},"entityId":{"type":"string"},"payload":{}},"required":["entityType"],"additionalProperties":false}},"required":["id","deletedAt"],"additionalProperties":false}},"databaseProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"deletedAt":{"type":"string","format":"date-time"},"deletedBy":{"$ref":"#/properties/databaseItems/items/properties/deletedBy"}},"required":["id","deletedAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["databaseItems","databaseProperties","hasMore"],"additionalProperties":false}}},{"key":"restore-database-trash-items","title":"Restore database trash items","description":"Restore soft-deleted database items from the trash, by ids or all matching the trash filters","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/trash-items/restore","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"restoredCount":{"type":"number"}},"required":["restoredCount"],"additionalProperties":false}}},{"key":"delete-database-item","title":"Delete database item","description":"Delete a single database item","group":"DatabaseItem","method":"DELETE","path":"/item/:databaseItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-database-item-values","title":"Update database item cell values","description":"Update cell values of a single database item.\nUse this to update cell values of one existing item.\nBefore every update, ALWAYS call get_database_properties for the parent database in the same turn.\nbody.cellValues keys must be database property IDs, not labels or names.\nBuild body.cellValues from the latest properties[].id and properties[].exampleCellValue returned by get_database_properties.\nFor constrained fields like status or dropdown, use the exact allowed IDs from the property metadata. Never send visible labels unless the example says so.\nWhen unsure what a property accepts, call get_database_property_possible_values for it: enumerable types (status, dropdown) return the full list of allowed IDs, every other type returns the exact example shape to send.\nReturns {jobId}: the write runs in the background, so the response is not yet a confirmation. Call get_job with that id to check whether it succeeded. A null jobId means the item was not published yet and the write already completed within this call.","group":"DatabaseItem","method":"PATCH","path":"/item/:databaseItemId/cell-values","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_item_cell_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"ID of the database item that should be updated."}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"cellValues":{"type":"object","additionalProperties":{},"description":"Cell values mapped by database property ID. Use property IDs as keys, not labels. Before updating an item, always call get_database_properties and build this object from properties[].id and properties[].exampleCellValue. Do not guess the shape. For constrained fields such as status or dropdown, use exact allowed option IDs rather than visible labels."}},"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":["string","null"]}},"required":["jobId"],"additionalProperties":false}}},{"key":"update-database-item-state","title":"Update database item state","description":"Update the state (published/draft/archived) of a database item","group":"DatabaseItem","method":"PUT","path":"/item/:databaseItemId/state","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_item_state","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"requestId":{"type":"string","description":"Optional client-generated request id, echoed back when a draft is published so the client can correlate its own publish with the broadcast."}},"required":["state"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-database-item-position","title":"Update database item position","description":"Update the manual order position of a database item by dropping it between two neighbours","group":"DatabaseItem","method":"PUT","path":"/item/:databaseItemId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"position":{"type":"string"}},"required":["position"],"additionalProperties":false}}},{"key":"get-database-groups","title":"Get database groups","description":"Get grouped database items by a property","group":"DatabaseItem","method":"POST","path":"/property/:databasePropertyId/groups","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_groups","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databasePropertyId":{"type":"string"}},"required":["databasePropertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"filter":{},"search":{"type":["string","null"]},"showAllDatabaseGroups":{"type":"boolean"},"groupGranularity":{"anyOf":[{"type":"string","enum":["day","week","month","quarter","year"]},{"type":"null"}]}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseGroupItems":{"type":"array","items":{"type":"object","properties":{"value":{},"quantity":{"type":"number"},"fullValue":{}},"required":["quantity"],"additionalProperties":false}},"snapshotTimestamp":{"type":"number"}},"required":["databaseGroupItems","snapshotTimestamp"],"additionalProperties":false}}},{"key":"count-database-items","title":"Count database items","description":"Count database items matching a filter","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items/quantity","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Count_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"filter":{},"search":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"quantity":{"type":"number"},"snapshotTimestamp":{"type":"number"}},"required":["quantity","snapshotTimestamp"],"additionalProperties":false}}},{"key":"get-similar-item-values","title":"Get similar item values","description":"Get similar database items based on filter criteria","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/similar","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_similar_item_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"filterQuery":{"type":"object","properties":{"filter":{},"group":{"type":["string","null"]},"offset":{"type":["number","null"]},"limit":{"type":["number","null"]},"search":{"type":["string","null"]},"sort":{"type":["string","null"]},"sortDirection":{"anyOf":[{"type":"string","enum":["1","-1"]},{"type":"null"}]},"propertyIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"hiddenPropertyIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"additionalProperties":false},"selectedItemIds":{"type":"array","items":{"type":"string"}},"unselect":{"type":"boolean"},"payload":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"item"},"databaseItemId":{"type":["string","null"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"group"},"propertyId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"groupValue":{}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"items-range"},"fromDatabaseItemId":{"type":["string","null"]},"databaseItemId":{"type":["string","null"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"group-items-range"},"fromDatabaseItemId":{"type":["string","null"]},"databaseItemId":{"type":["string","null"]},"propertyId":{"type":"string","minLength":1},"groupGranularity":{"anyOf":[{"type":"string","enum":["day","week","month","quarter","year"]},{"type":"null"}]},"groupSortMode":{"anyOf":[{"type":"string","enum":["natural","valueAsc","valueDesc","countAsc","countDesc"]},{"type":"null"}]},"groupEmptyPlacement":{"anyOf":[{"type":"string","enum":["top","bottom"]},{"type":"null"}]}},"required":["type","propertyId"],"additionalProperties":false}]}},"required":["filterQuery","selectedItemIds","unselect","payload"],"additionalProperties":false},"response":{"type":"object","properties":{"selectedItemIds":{"type":"array","items":{"type":"string"}},"sameValues":{"type":"object","additionalProperties":{}},"title":{"type":"string"},"quantity":{"type":"number"}},"required":["selectedItemIds","sameValues","title","quantity"],"additionalProperties":false}}},{"key":"clone-database-items","title":"Clone database items","description":"Clone one or more database items","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items/clone","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Clone_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"databaseItemIds":{"type":"array","items":{"type":"string"}}},"required":["databaseItemIds"],"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"get-database-property-values","title":"Get database property values","description":"Get unique values for a database property","group":"DatabaseItem","method":"POST","path":"/database-property/:propertyId/unique-values","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_property_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"filter":{}},"additionalProperties":false},"response":{"type":"object","properties":{"propertyValues":{"type":"array","items":{}}},"required":["propertyValues"],"additionalProperties":false}}},{"key":"get-database-item-summary","title":"Get database item AI summary","description":"Get an AI-generated summary for a database item","group":"DatabaseItem","method":"GET","path":"/item/:databaseItemId/summary/ai","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_item_AI_summary","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"],"additionalProperties":false}}},{"key":"get-location-clustered-items","title":"Get location clustered items","description":"Get database items with location data, optionally clustered","group":"DatabaseItem","method":"POST","path":"/items/geopoints","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_location_clustered_items","surface":"search"},"schemas":{"params":null,"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"layers":{"type":"array","items":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseId":{"type":"string"},"options":{"type":"object","properties":{"icon":{"type":"object","properties":{"name":{"type":"string"},"unicode":{"type":"string"},"size":{"type":"number"}},"required":["name","unicode","size"],"additionalProperties":false},"colorByField":{"type":"boolean"},"color":{},"colorPropertySourceId":{"type":"string"},"filter":{}},"required":["icon","colorByField"],"additionalProperties":false}},"required":["propertyId","databaseId","options"],"additionalProperties":false}},"zoom":{"type":"number"},"useClustering":{"type":"boolean"},"maxPoints":{"type":"integer","minimum":1,"maximum":50000},"bounds":{"type":"array","minItems":4,"maxItems":4,"items":[{"type":"number","minimum":-180,"maximum":180},{"type":"number","minimum":-90,"maximum":90},{"type":"number","minimum":-180,"maximum":180},{"type":"number","minimum":-90,"maximum":90}]}},"required":["layers"],"additionalProperties":false},"response":{"type":"object","properties":{"clusters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"Feature"},"geometry":{"type":"object","properties":{"type":{"type":"string","const":"Point"},"coordinates":{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"number"},{"type":"number"}]}},"required":["type","coordinates"],"additionalProperties":false},"properties":{"type":"object","properties":{"isCluster":{"type":"boolean"},"pointCount":{"type":"number"},"clusterId":{"type":"number"},"databaseItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"colorValue":{},"locationPropertyId":{"type":"string"},"databaseId":{"type":"string"}},"additionalProperties":false}},"required":["type","geometry","properties"],"additionalProperties":false}},"truncated":{"type":"boolean"}},"required":["clusters"],"additionalProperties":false}}},{"key":"delete-database-items","title":"Delete database items","description":"Delete multiple database items","group":"DatabaseItem","method":"DELETE","path":"/database/:databaseId/items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"databaseItemIds":{"type":"array","items":{"type":"string"}}},"required":["databaseItemIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-cell-values-of-multiple-items","title":"Update cell values of multiple items","description":"Update cell values for multiple database items at once, applying the SAME values to every listed item. Returns {jobId}: the write runs in the background, so call get_job with that id to check whether it succeeded.","group":"DatabaseItem","method":"PATCH","path":"/database/:databaseId/items/cell-values","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_cell_values_of_multiple_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"cellValues":{"type":"object","additionalProperties":{}},"databaseItemIds":{"type":"array","items":{"type":"string"}}},"required":["databaseItemIds"],"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":["string","null"]}},"required":["jobId"],"additionalProperties":false}}},{"key":"update-multiple-items-different-values","title":"Update multiple items with different values","description":"Update many database items in one request, each with its OWN different cell values. Use this instead of calling update-database-item-values once per item. updatedCount is how many updates were accepted, not how many were written — the write runs in the background, so call get_job with the returned jobId to check whether it succeeded.","group":"DatabaseItem","method":"PATCH","path":"/database/:databaseId/items/cell-values-per-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_multiple_items_with_different_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"updates":{"type":"array","items":{"type":"object","properties":{"databaseItemId":{"type":"string"},"cellValues":{"type":"object","additionalProperties":{}}},"required":["databaseItemId","cellValues"],"additionalProperties":false},"minItems":1,"description":"One entry per item, each with its OWN cell values — use this to set different values on many items in a single call instead of updating each item separately. Fetch the database schema with get_database_properties first and build the cellValues for each entry from properties[].id and the expected value format. Keep each call to a reasonable batch (around 50 items); split larger amounts into several calls."}},"required":["updates"],"additionalProperties":false},"response":{"type":"object","properties":{"updatedCount":{"type":"number"},"jobId":{"type":"string"}},"required":["updatedCount","jobId"],"additionalProperties":false}}},{"key":"get-items-by-column-union-order","title":"Get items by column union order","description":"Get database items ordered by union of multiple column values","group":"DatabaseItem","method":"POST","path":"/database/:databaseId/items/column-union-order","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_items_by_column_union_order","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"limit":{"type":"number"},"offset":{"type":"number"}},"additionalProperties":false},"body":{"type":"object","properties":{"filter":{},"propertyIds":{"type":"array","items":{"type":"string"}},"sortDirection":{"type":"string","enum":["1","-1"]},"skipEmptyValues":{"type":"boolean"},"search":{"type":["string","null"]}},"required":["propertyIds","sortDirection","skipEmptyValues"],"additionalProperties":false},"response":{"type":"object","properties":{"databaseItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string","enum":["archived","published","pending-submission","draft"]},"cellValues":{"type":"object","additionalProperties":{"type":"object","properties":{"value":{},"valueType":{"type":"string"},"sourceItemId":{"type":"string"}},"required":["valueType"],"additionalProperties":false}}},"required":["id","name","state","cellValues"],"additionalProperties":false}}},"required":["databaseItems"],"additionalProperties":false}}},{"key":"create-database-property","title":"Create database property","description":"Create a new property in a database","group":"DatabaseProperty","method":"POST","path":"/database/:databaseId/property","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"type":{"type":"string","enum":["text","long-text","markdown","number","boolean","dropdown","date","time","date-range","teleport","reverse-relation","relation","formula","phone","location","mail","link","people","rating","comments","files","status","id","auto-id","random-id","time-tracker","created-at","updated-at","checklist","vote"]},"title":{"type":"string"},"width":{"type":"number","minimum":10,"maximum":2000},"position":{"type":"number","minimum":0},"options":{"type":"object","additionalProperties":{},"description":"Type-specific configuration; the accepted keys depend on the property type. Before setting options, fetch the available property types and their option shapes for the target database (do not guess) and use only the keys defined for the chosen type — unknown keys are rejected. For status/dropdown/list, create the property without options and add values afterwards via create_status (status columns) or create_dropdown_label (dropdown columns)."},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"}},"required":["type"],"additionalProperties":false},"response":{"type":"object","properties":{"property":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}},"required":["property"],"additionalProperties":false}}},{"key":"create-database-properties","title":"Create multiple database properties","description":"Create multiple properties in a database in a single request","group":"DatabaseProperty","method":"POST","path":"/database/:databaseId/properties/create","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_multiple_database_properties","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["text","long-text","markdown","number","boolean","dropdown","date","time","date-range","teleport","reverse-relation","relation","formula","phone","location","mail","link","people","rating","comments","files","status","id","auto-id","random-id","time-tracker","created-at","updated-at","checklist","vote"]},"title":{"type":"string"},"width":{"type":"number","minimum":10,"maximum":2000},"position":{"type":"number","minimum":0},"options":{"type":"object","additionalProperties":{},"description":"Type-specific configuration; the accepted keys depend on the property type. Fetch the available property types and their option shapes for the target database first (do not guess) and use only the keys defined for the chosen type. For status/dropdown/list, omit options and add values afterwards via create_status (status columns) or create_dropdown_label (dropdown columns)."},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"}},"required":["type"],"additionalProperties":false},"minItems":1},"state":{"type":"string","enum":["archived","published","draft"]}},"required":["properties"],"additionalProperties":false},"response":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}}},"required":["properties"],"additionalProperties":false}}},{"key":"get-database-property","title":"Get database property","description":"Get a single database property by its ID","group":"DatabaseProperty","method":"GET","path":"/property/:propertyId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"property":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}},"required":["property"],"additionalProperties":false}}},{"key":"get-database-properties","title":"Get database properties","description":"Get all properties for a database.\nUse this before creating or updating items to learn property IDs, names, types, metadata, and an exampleCellValue for each property.\nFor every property, properties[].exampleCellValue shows the expected shape of body.cellValues[propertyId], and properties[].exampleCellValueDescription explains how to use it.","group":"DatabaseProperty","method":"GET","path":"/database/:databaseId/properties","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_properties","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string","description":"ID of the database whose properties should be returned."}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"includeDrafts":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"},"exampleCellValue":{},"exampleCellValueDescription":{"type":"string"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}}},"required":["properties"],"additionalProperties":false}}},{"key":"update-database-property","title":"Update database property","description":"Update a single database property","group":"DatabaseProperty","method":"PATCH","path":"/property/:propertyId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"options":{},"title":{"type":"string"},"description":{"type":["string","null"]},"barColor":{},"defaultStoredValue":{},"alignment":{"type":"string","enum":["left","center","right"]},"width":{"type":"number","minimum":10},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"},"state":{"type":"string","enum":["archived","published","draft"]},"valueType":{"type":"string","enum":["auto-id","boolean","formula","link","date","mail","number","checkbox","text","textarea","markdown","file","person","people","phone","location","rating","relation","time-tracker","reverse-relation","status","dropdown","error","comments","summary","entity-with-date","color-group","created-at","updated-at","checklist","vote","time-tracker-sum"]},"valueTypeOptions":{},"id":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-database-properties","title":"Update database properties","description":"Update multiple database properties","group":"DatabaseProperty","method":"PATCH","path":"/database/:databaseId/properties","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_properties","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"options":{},"title":{"type":"string"},"description":{"type":["string","null"]},"barColor":{},"defaultStoredValue":{},"alignment":{"type":"string","enum":["left","center","right"]},"width":{"type":"number","minimum":10},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"},"state":{"type":"string","enum":["archived","published","draft"]},"valueType":{"type":"string","enum":["auto-id","boolean","formula","link","date","mail","number","checkbox","text","textarea","markdown","file","person","people","phone","location","rating","relation","time-tracker","reverse-relation","status","dropdown","error","comments","summary","entity-with-date","color-group","created-at","updated-at","checklist","vote","time-tracker-sum"]},"valueTypeOptions":{},"id":{"type":"string"}},"additionalProperties":false}}},"required":["properties"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-property","title":"Delete database property","description":"Delete a single database property","group":"DatabaseProperty","method":"DELETE","path":"/property/:propertyId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-properties","title":"Delete database properties","description":"Delete multiple database properties","group":"DatabaseProperty","method":"DELETE","path":"/database/:databaseId/properties","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database_properties","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"propertyIds":{"type":"array","items":{"type":"string"}}},"required":["propertyIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-properties-by-database-ids","title":"Get properties by database IDs","description":"Get properties for multiple databases","group":"DatabaseProperty","method":"POST","path":"/properties","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_properties_by_database_IDs","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"databaseIds":{"type":"array","items":{"type":"string"}},"includeDrafts":{"type":"string"}},"required":["databaseIds"],"additionalProperties":false},"response":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}}},"required":["properties"],"additionalProperties":false}}},{"key":"update-database-property-position","title":"Update database property position","description":"Update the position of a database property","group":"DatabaseProperty","method":"PUT","path":"/property/:propertyId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_property_position","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"offset":{"type":"number"},"currentViewId":{"type":["string","null"]}},"required":["offset","currentViewId"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"duplicate-database-property","title":"Duplicate database property","description":"Duplicate a database property","group":"DatabaseProperty","method":"POST","path":"/property/:propertyId/duplicate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Duplicate_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"withItems":{"type":"boolean"}},"required":["withItems"],"additionalProperties":false},"response":{"type":"object","properties":{"property":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false}},"required":["property"],"additionalProperties":false}}},{"key":"convert-database-property-value","title":"Convert database property value","description":"Convert a stored value to full value for a property","group":"DatabaseProperty","method":"POST","path":"/property/:propertyId/full-value","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Convert_database_property_value","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"value":{}},"additionalProperties":false},"response":{"type":"object","properties":{"fullValue":{}},"additionalProperties":false}}},{"key":"get-database-property-full-data-options","title":"Get database property full data options","description":"Get full data options for a property","group":"DatabaseProperty","method":"GET","path":"/property/:propertyId/full-data-options","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_property_full_data_options","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"fullDataOptions":{}},"additionalProperties":false}}},{"key":"get-database-properties-full-data-options","title":"Get database properties full data options","description":"Get full data options for multiple properties","group":"DatabaseProperty","method":"POST","path":"/database/:databaseId/properties/full-data-options","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_properties_full_data_options","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"propertyIds":{"type":"array","items":{"type":"string"}}},"required":["propertyIds"],"additionalProperties":false},"response":{"type":"object","properties":{"propertiesFullDataOptions":{"type":"object","additionalProperties":{}}},"required":["propertiesFullDataOptions"],"additionalProperties":false}}},{"key":"generate-database-property-summary-value","title":"Generate database property summary value","description":"Generate a summary value for a property","group":"DatabaseProperty","method":"POST","path":"/database/:databaseId/property/:propertyId/summary-value","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_database_property_summary_value","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseId","propertyId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"filter":{},"currentGroupId":{"type":"string"},"currentGroupValue":{"anyOf":[{"type":"array","items":{}}]},"summaryConfig":{"type":"array","items":{}}},"additionalProperties":false},"response":{"type":"object","properties":{"summaryValue":{}},"additionalProperties":false}}},{"key":"generate-summaries-for-group","title":"Generate summaries for group","description":"Generate summary values for multiple properties in a group","group":"DatabaseProperty","method":"POST","path":"/database/:databaseId/summaries-for-group","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_summaries_for_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":{"type":"object","properties":{"filter":{},"currentGroupId":{"type":"string"},"currentGroupValue":{},"summaryConfig":{"type":"array","items":{}}},"additionalProperties":false},"response":{"type":"object","properties":{"summaryDataArray":{"type":"array","items":{}}},"required":["summaryDataArray"],"additionalProperties":false}}},{"key":"convert-database-property","title":"Convert database property","description":"Convert a property to a different type","group":"DatabaseProperty","method":"PUT","path":"/property/:propertyId/type","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Convert_database_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"type":{"type":"string","enum":["text","long-text","markdown","number","boolean","dropdown","date","time","date-range","teleport","reverse-relation","relation","formula","phone","location","mail","link","people","rating","comments","files","status","id","auto-id","random-id","time-tracker","created-at","updated-at","checklist","vote"]},"replace":{"type":"boolean"}},"required":["type"],"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"get-database-property-possible-values","title":"Get database property possible values","description":"Find out what a property accepts as a cell value. Works for EVERY property type — call it whenever a write was rejected or the expected shape is unclear.\npossibleValues is the list of values already in use, with a count per value. inputContract.valuesAreEnumerable tells you how to read that list: true for closed dictionaries (status, dropdown) means a cell value MUST be one of those IDs; false (relation, people, date, text, number, ...) means it is only a sample of current usage, not a constraint.\nFor non-enumerable types, inputContract.exampleCellValue is the answer: it is the exact shape to send as cellValues[propertyId], and exampleCellValueDescription explains it. Do not expect a list of allowed values for those types — a date or a number has no such list.\nSend the ID from possibleValues, never the label shown in the UI, unless exampleCellValue itself is a label.","group":"DatabaseProperty","method":"GET","path":"/property/:propertyId/possible-values","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"get_database_property_possible_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string","description":"ID of the database property whose allowed or suggested values should be returned."}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"property":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"type":{"type":"string"},"databaseId":{"type":"string"},"width":{"type":"number"},"options":{},"hasFullDataOptions":{"type":"boolean"},"valueType":{"type":"string"},"defaultStoredValue":{"type":"object","properties":{"type":{"type":"string"},"value":{}},"required":["type"],"additionalProperties":false},"canBeModified":{"type":"boolean"},"isSummaryAvailable":{"type":"boolean"},"canUpdateAlignment":{"type":"boolean"},"alignment":{"type":"string","enum":["left","center","right"]},"canBeModifiedDirectly":{"type":"boolean"},"isBeingProcessed":{"type":"boolean"},"processProgress":{"type":"number"},"optionData":{},"position":{"type":"number"},"barColor":{},"valueTypeOptions":{},"valueTypeOptionData":{},"state":{"type":"string","enum":["archived","published","draft"]},"isPinned":{"type":"boolean"},"isMasked":{"type":"boolean"}},"required":["id","title","type","databaseId","width","hasFullDataOptions","valueType","defaultStoredValue","canBeModified","isSummaryAvailable","canUpdateAlignment","alignment","canBeModifiedDirectly","isBeingProcessed","position","state","isPinned","isMasked"],"additionalProperties":false},"possibleValues":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"possibleValue":{},"count":{"type":"number"}},"required":["count"],"additionalProperties":false}},{"type":"null"}]},"inputContract":{"type":"object","properties":{"valuesAreEnumerable":{"type":"boolean"},"possibleValuesTruncated":{"type":"boolean"},"exampleCellValue":{},"exampleCellValueDescription":{"type":["string","null"]}},"required":["valuesAreEnumerable","possibleValuesTruncated","exampleCellValueDescription"],"additionalProperties":false}},"required":["property","possibleValues","inputContract"],"additionalProperties":false}}},{"key":"get-date-property-affected-values","title":"Get affected date values","description":"Returns whether the Date property has any items with a time component or a range end set.","group":"DatabaseProperty","method":"GET","path":"/property/:propertyId/affected-date-values","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"hasTimeValues":{"type":"boolean"},"hasRangeValues":{"type":"boolean"}},"required":["hasTimeValues","hasRangeValues"],"additionalProperties":false}}},{"key":"backfill-database-property-file-descriptions","title":"Backfill file descriptions for a database property","description":"Order AI descriptions for the files already in a Files property that have none yet. Call with dryRun to preview the count without enqueueing anything.","group":"DatabaseProperty","method":"POST","path":"/property/:propertyId/backfill-descriptions","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"dryRun":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"missingCount":{"type":"number"},"isEnqueued":{"type":"boolean"}},"required":["missingCount","isEnqueued"],"additionalProperties":false}}},{"key":"get-resource-spaces","title":"Get resource spaces","description":"Get all resource spaces in a workspace","group":"ResourceSpace","method":"GET","path":"/workspace/:workspaceId/resource-spaces","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_resource_spaces","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"resourceSpaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false},"name":{"type":"string"},"position":{"type":"number"},"iconNameType":{"type":["string","null"]},"particularColor":{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","enum":["palette","custom"]},"payload":{}},"required":["colorType"],"additionalProperties":false},{"type":"null"}]},"isDefault":{"type":"boolean"}},"required":["id"],"additionalProperties":false}}},"required":["resourceSpaces"],"additionalProperties":false}}},{"key":"create-resource-space","title":"Create resource space","description":"Create a new resource space in a workspace","group":"ResourceSpace","method":"POST","path":"/workspace/:workspaceId/resource-space","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_resource_space","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"resourceSpace":{"type":"object","properties":{"id":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false},"name":{"type":"string"},"position":{"type":"number"},"iconNameType":{"type":["string","null"]},"particularColor":{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","enum":["palette","custom"]},"payload":{}},"required":["colorType"],"additionalProperties":false},{"type":"null"}]},"isDefault":{"type":"boolean"}},"required":["id"],"additionalProperties":false}},"required":["resourceSpace"],"additionalProperties":false}}},{"key":"update-resource-space-name","title":"Update resource space name","description":"Update the name of a resource space","group":"ResourceSpace","method":"PUT","path":"/resource-space/:resourceSpaceId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_resource_space_name","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceSpaceId":{"type":"string"}},"required":["resourceSpaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"resourceSpace":{"type":"object","properties":{"id":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false},"name":{"type":"string"},"position":{"type":"number"},"iconNameType":{"type":["string","null"]},"particularColor":{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","enum":["palette","custom"]},"payload":{}},"required":["colorType"],"additionalProperties":false},{"type":"null"}]},"isDefault":{"type":"boolean"}},"required":["id"],"additionalProperties":false}},"required":["resourceSpace"],"additionalProperties":false}}},{"key":"delete-resource-space","title":"Delete resource space","description":"Delete a resource space, optionally with its content","group":"ResourceSpace","method":"DELETE","path":"/resource-space/:resourceSpaceId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_resource_space","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceSpaceId":{"type":"string"}},"required":["resourceSpaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"withContent":{"type":"boolean"}},"required":["withContent"],"additionalProperties":false},"response":{"type":"object","properties":{"destinationResourceSpaceId":{"type":["string","null"]}},"required":["destinationResourceSpaceId"],"additionalProperties":false}}},{"key":"get-collection-items","title":"Get collection items","description":"Get all collection items in a workspace","group":"Collection","method":"GET","path":"/workspace/:workspaceId/collection-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_collection_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"collectionItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"builtInType":{"anyOf":[{"type":"string","enum":["favourites","archive"]},{"type":"null"}]},"collectionItemType":{"type":"string","enum":["folder","resource","link"]},"collectionItemTypePayload":{},"parentCollectionId":{"type":["string","null"]},"position":{"type":"number"},"workspaceId":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false}},"required":["id","collectionItemType","workspaceId"],"additionalProperties":false}}},"required":["collectionItems"],"additionalProperties":false}}},{"key":"create-collection-item","title":"Create collection item","description":"Create a collection item in a workspace","group":"Collection","method":"POST","path":"/workspace/:workspaceId/collection-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_collection_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"collectionItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"builtInType":{"anyOf":[{"type":"string","enum":["favourites","archive"]},{"type":"null"}]},"collectionItemType":{"type":"string","enum":["folder","resource","link"]},"collectionItemTypePayload":{},"parentCollectionId":{"type":["string","null"]},"position":{"type":"number"},"workspaceId":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false}},"required":["id","collectionItemType","workspaceId"],"additionalProperties":false}},"required":["collectionItem"],"additionalProperties":false}}},{"key":"update-collection-item","title":"Update collection item","description":"Update a collection item","group":"Collection","method":"PUT","path":"/collection-item/:collectionItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_collection_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"collectionItemId":{"type":"string"}},"required":["collectionItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentCollectionId":{"type":["string","null"]},"position":{"type":"integer","minimum":0},"collectionItemTypePayload":{"type":"object","properties":{"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"particularColor":{"anyOf":[{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},{"type":"null"}]},"url":{"type":"string","minLength":1,"maxLength":2048}},"additionalProperties":false}},"additionalProperties":false},"response":{"type":"object","properties":{"collectionItem":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"builtInType":{"anyOf":[{"type":"string","enum":["favourites","archive"]},{"type":"null"}]},"collectionItemType":{"type":"string","enum":["folder","resource","link"]},"collectionItemTypePayload":{},"parentCollectionId":{"type":["string","null"]},"position":{"type":"number"},"workspaceId":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false}},"required":["id","collectionItemType","workspaceId"],"additionalProperties":false}},"required":["collectionItem"],"additionalProperties":false}}},{"key":"delete-collection-item","title":"Delete collection item","description":"Delete a collection item","group":"Collection","method":"DELETE","path":"/collection-item/:collectionItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_collection_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"collectionItemId":{"type":"string"}},"required":["collectionItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-collection-item-membership","title":"Update collection item membership","description":"Add or remove a resource from a collection folder","group":"Collection","method":"PUT","path":"/workspace/:workspaceId/collection-item/membership","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_collection_item_membership","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"parentCollectionId":{"type":["string","null"]},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string","minLength":1},"isMember":{"type":"boolean"},"position":{"type":"integer","minimum":0}},"required":["parentCollectionId","resourceType","resourceId","isMember"],"additionalProperties":false},"response":{"type":"object","properties":{"collectionItem":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"builtInType":{"anyOf":[{"type":"string","enum":["favourites","archive"]},{"type":"null"}]},"collectionItemType":{"type":"string","enum":["folder","resource","link"]},"collectionItemTypePayload":{},"parentCollectionId":{"type":["string","null"]},"position":{"type":"number"},"workspaceId":{"type":"string"},"authorEntity":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false}},"required":["id","collectionItemType","workspaceId"],"additionalProperties":false},{"type":"null"}]}},"required":["collectionItem"],"additionalProperties":false}}},{"key":"get-workspace-groups","title":"Get workspace groups","description":"List all groups in a workspace. Requires readWorkspace permission.","group":"Group","method":"GET","path":"/workspace/:workspaceId/groups","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_groups","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"groups":{"type":"array","items":{}}},"required":["groups"],"additionalProperties":false}}},{"key":"get-workspace-groups-with-members","title":"Get workspace groups with members","description":"List all groups in a workspace together with their member ids. Requires readWorkspace permission.","group":"Group","method":"GET","path":"/workspace/:workspaceId/groups-with-members","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_groups_with_members","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"groupsWithMembers":{"type":"array","items":{}}},"required":["groupsWithMembers"],"additionalProperties":false}}},{"key":"get-group","title":"Get group","description":"Get a single group by id. Requires readWorkspace permission on the parent workspace.","group":"Group","method":"GET","path":"/workspace/:workspaceId/group/:groupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"team":{}},"additionalProperties":false}}},{"key":"create-group","title":"Create group","description":"Create a new group within a workspace. Color is auto-assigned from the palette. Requires createUserGroup permission.","group":"Group","method":"POST","path":"/workspace/:workspaceId/group","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"color":{}},"additionalProperties":false},"response":{"type":"object","properties":{"group":{}},"additionalProperties":false}}},{"key":"update-group","title":"Update group","description":"Update title and/or color of an existing group. Requires updateUserGroup permission.","group":"Group","method":"PATCH","path":"/workspace/:workspaceId/group/:groupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":["string","null"]},"color":{},"licensedSeats":{"type":"integer","minimum":0}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-group","title":"Delete group","description":"Delete a group. Fails if the group still has members - remove them first, or if the group is built-in. Requires deleteUserGroup permission.","group":"Group","method":"DELETE","path":"/workspace/:workspaceId/group/:groupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"add-users-to-group","title":"Add users to group","description":"Add one or more users to a group. Already-present users are skipped. Invalidates permission cache. Requires createGroupMember permission.","group":"Group","method":"POST","path":"/workspace/:workspaceId/group/:groupId/users","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Add_users_to_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}}},"required":["userIds"],"additionalProperties":false},"response":{"type":"object","properties":{"licensedSeats":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["licensedSeats"],"additionalProperties":false}}},{"key":"get-group-members","title":"Get group members","description":"List user members of a group with their user data populated. Requires readWorkspace permission.","group":"Group","method":"GET","path":"/workspace/:workspaceId/group/:groupId/users","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_group_members","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"users":{"type":"array","items":{}}},"required":["users"],"additionalProperties":false}}},{"key":"remove-group-member","title":"Remove group member","description":"Remove a single user from a group. Invalidates permission cache. Requires deleteGroupMember permission.","group":"Group","method":"DELETE","path":"/workspace/:workspaceId/group/:groupId/user/:userId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Remove_group_member","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1}},"required":["workspaceId","groupId","userId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"remove-group-members","title":"Remove group members","description":"Bulk-remove multiple users from a group via soft-delete. Invalidates permission cache. Requires deleteGroupMember permission.","group":"Group","method":"DELETE","path":"/workspace/:workspaceId/group/:groupId/users","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Remove_group_members","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"groupId":{"type":"string","minLength":1}},"required":["workspaceId","groupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}}},"required":["userIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-group-priorities","title":"Update group priorities","description":"Reorder workspace groups by priority. First group id receives the highest priority. Requires updateUserGroup permission.","group":"Group","method":"PATCH","path":"/workspace/:workspaceId/groups/priorities","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_group_priorities","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"groupIds":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["groupIds"],"additionalProperties":false},"response":{"type":"object","properties":{"groups":{"type":"array","items":{}}},"required":["groups"],"additionalProperties":false}}},{"key":"create-call-room","title":"Create call room","description":"Create a new call room in a workspace. Requires createCallRoom permission. Persists the room as a CallRoom resource, registers admin permissions for the creating entity, attaches a ResourceItem inside the workspace (optionally inside a resourceGroup/resourceSpace), and returns the populated room.","group":"CallRoom","method":"POST","path":"/workspace/:workspaceId/call-room","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_call_room","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"callRoom":{}},"additionalProperties":false}}},{"key":"get-call-room","title":"Get call room","description":"Fetch a single call room by id, with the author entity populated. Permissions check is intentionally not yet enforced — preserves legacy controller behavior.","group":"CallRoom","method":"GET","path":"/call-room/:callRoomId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_call_room","surface":"search"},"schemas":{"params":{"type":"object","properties":{"callRoomId":{"type":"string","minLength":1}},"required":["callRoomId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"callRoom":{}},"additionalProperties":false}}},{"key":"create-folder","title":"Create folder","description":"Create a folder inside a workspace, optionally inside a resource group/space, and optionally make it private.","group":"Folder","method":"POST","path":"/workspace/:workspaceId/folder","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_folder","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"folder":{}},"additionalProperties":false}}},{"key":"get-folder","title":"Get folder","description":"Fetch a folder by id; requires read permission on the folder.","group":"Folder","method":"GET","path":"/folder/:folderId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_folder","surface":"search"},"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"folder":{}},"additionalProperties":false}}},{"key":"update-folder","title":"Update folder","description":"Update a folder's name or its settings; requires update permission on the folder.","group":"Folder","method":"PATCH","path":"/folder/:folderId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_folder","surface":"search"},"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string","minLength":1}},"required":["folderId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"isAiDescriptionEnabled":{"type":"boolean"},"aiDescriptionInstruction":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"additionalProperties":false},"response":{"type":"object","properties":{"folder":{}},"additionalProperties":false}}},{"key":"backfill-folder-file-descriptions","title":"Backfill file descriptions for a folder","description":"Order AI descriptions for the files already in a folder that have none yet. Call with dryRun to preview the count without enqueueing anything.","group":"Folder","method":"POST","path":"/folder/:folderId/backfill-descriptions","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string"}},"required":["folderId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"dryRun":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"missingCount":{"type":"number"},"isEnqueued":{"type":"boolean"}},"required":["missingCount","isEnqueued"],"additionalProperties":false}}},{"key":"create-workspace-invitation","title":"Create workspace invitation","description":"Invite a user to a workspace by email. Sends an invitation email with an acceptance link. Requires createUserInvitation permission on the workspace.","group":"WorkspaceInvitation","method":"POST","path":"/workspace/:workspaceId/invite","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_workspace_invitation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"mailAddresses":{"type":"array","items":{"type":"string","minLength":1}},"groupIds":{"type":"array","items":{"type":"string"}},"expiresInMinutes":{"type":"integer","exclusiveMinimum":0},"maxUses":{"type":"integer","exclusiveMinimum":0}},"required":["groupIds"],"additionalProperties":false},"response":{"type":"object","properties":{"url":{"type":"string"},"expiresAt":{"type":"string"},"workspaceInvitations":{"type":"array","items":{}},"inviteResults":{"type":"array","items":{"type":"object","properties":{"mail":{"type":"string"},"status":{"type":"string","enum":["sent","added","alreadyMember","alreadyInvited","invalid"]}},"required":["mail","status"],"additionalProperties":false}}},"additionalProperties":false}}},{"key":"get-workspace-invitations","title":"Get workspace invitations","description":"List all pending workspace invitations for a workspace. Requires readUserInvitation permission.","group":"WorkspaceInvitation","method":"GET","path":"/workspace/:workspaceId/invitations","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_invitations","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"workspaceInvitations":{"type":"array","items":{}}},"required":["workspaceInvitations"],"additionalProperties":false}}},{"key":"accept-workspace-invitation","title":"Accept workspace invitation","description":"Accept a workspace invitation using the invitation id and secret from the invitation link. Adds the current user to the workspace and any specified groups.","group":"WorkspaceInvitation","method":"POST","path":"/workspace-invitation/:invitationId-:invitationSecret/accept","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Accept_workspace_invitation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"invitationId":{"type":"string","minLength":1},"invitationSecret":{"type":"string","minLength":1}},"required":["invitationId","invitationSecret"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-workspace-invitation","title":"Get workspace invitation","description":"Public endpoint that fetches workspace invitation details by id and secret. Used on the unauthenticated invitation landing page.","group":"WorkspaceInvitation","method":"GET","path":"/workspace-invitation/:invitationId-:invitationSecret","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"invitationId":{"type":"string","minLength":1},"invitationSecret":{"type":"string","minLength":1}},"required":["invitationId","invitationSecret"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"workspaceInvitation":{}},"additionalProperties":false}}},{"key":"update-workspace-invitation","title":"Update workspace invitation","description":"Update the group membership of a pending workspace invitation. Requires updateUserInvitation and createGroupMember permissions.","group":"WorkspaceInvitation","method":"PUT","path":"/workspace/:workspaceId/invitation/:invitationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_workspace_invitation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"invitationId":{"type":"string","minLength":1}},"required":["workspaceId","invitationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"groupIds":{"type":"array","items":{"type":"string"}}},"required":["groupIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-workspace-invitation","title":"Delete workspace invitation","description":"Delete a pending workspace invitation. Only the original author of the invitation may delete it. Requires deleteUserInvitation permission.","group":"WorkspaceInvitation","method":"DELETE","path":"/workspace/:workspaceId/invitation/:invitationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_workspace_invitation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"invitationId":{"type":"string","minLength":1}},"required":["workspaceId","invitationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"substituteUserId":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"toggle-vote","title":"Toggle vote on a database item","description":"Cast or retract the current user's vote on a database item for a vote-typed property. Returns the updated count and the latest voters.","group":"Vote","method":"POST","path":"/item/:databaseItemId/property/:propertyId/vote","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Toggle_vote_on_a_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"vote":{"type":"boolean"}},"required":["vote"],"additionalProperties":false},"response":{"type":"object","properties":{"hasCurrentUserVoted":{"type":"boolean"},"count":{"type":"number"},"latestEntities":{"type":"array","items":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":"string"},"payload":{"anyOf":[{},{"type":"null"}]}},"required":["entityType","entityId"],"additionalProperties":false}}},"required":["hasCurrentUserVoted","count","latestEntities"],"additionalProperties":false}}},{"key":"get-voters","title":"Get voters for a database item","description":"Returns the paginated list of entities (typically users) who have voted on a database item for a vote-typed property.","group":"Vote","method":"GET","path":"/item/:databaseItemId/property/:propertyId/voters","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_voters_for_a_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":{"type":"object","properties":{"skip":{"type":"integer","minimum":0},"limit":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"entities":{"type":"array","items":{"type":"object","properties":{"entityType":{"type":"string"},"entityId":{"type":"string"},"payload":{"anyOf":[{},{"type":"null"}]}},"required":["entityType","entityId"],"additionalProperties":false}},"total":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["entities","total","hasMore"],"additionalProperties":false}}},{"key":"create-label","title":"Create dropdown label","description":"Add a new label option to a dropdown-typed property. Only Dropdown properties accept labels. Call this after creating a dropdown property, once per option, then read the option IDs back with get_database_property_possible_values before writing any cell. position is optional: omit it to append the label at the end of the list; the list order is the order items sort in when the column is sorted.","group":"Label","method":"POST","path":"/property/:propertyId/label","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"create_dropdown_label","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"color":{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},"position":{"type":"number"}},"required":["title","color"],"additionalProperties":false},"response":{"type":"object","properties":{"label":{}},"additionalProperties":false}}},{"key":"update-label","title":"Update dropdown label","description":"Update a label's title, color, or position within a dropdown property.","group":"Label","method":"PATCH","path":"/label/:labelId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_dropdown_label","surface":"search"},"schemas":{"params":{"type":"object","properties":{"labelId":{"type":"string"}},"required":["labelId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"color":{},"position":{"type":"number"}},"additionalProperties":false},"response":{"type":"object","properties":{"label":{}},"additionalProperties":false}}},{"key":"delete-label","title":"Delete dropdown label","description":"Delete a label from a dropdown property. DESTRUCTIVE — fails if the label is in use by any item.","group":"Label","method":"DELETE","path":"/label/:labelId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_dropdown_label","surface":"search"},"schemas":{"params":{"type":"object","properties":{"labelId":{"type":"string"}},"required":["labelId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-labels","title":"List dropdown labels","description":"Returns all labels associated with a dropdown property in their stored order.","group":"Label","method":"GET","path":"/property/:propertyId/labels","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_dropdown_labels","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"labels":{"type":"array"}},"required":["labels"],"additionalProperties":false}}},{"key":"get-is-label-in-use","title":"Check if a label is in use","description":"Returns true if any item in the database currently has the given label assigned to the given property. Use before deleteLabel to avoid the in-use error.","group":"Label","method":"GET","path":"/property/:propertyId/label/:labelId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Check_if_a_label_is_in_use","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"labelId":{"type":"string"}},"required":["propertyId","labelId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"isLabelInUse":{"type":"boolean"}},"required":["isLabelInUse"],"additionalProperties":false}}},{"key":"get-app-categories","title":"Get app categories","description":"List all app categories used to group the automation app catalog. Includes the count of apps per category.","group":"AppCategory","method":"GET","path":"/app-categories","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_app_categories","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"appCategories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key":{"type":"string"},"automationAppCount":{"type":"number"},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]}},"required":["id","name","key","automationAppCount","iconNameType"],"additionalProperties":false}}},"required":["appCategories"],"additionalProperties":false}}},{"key":"create-link","title":"Create link","description":"Create a named link attached to a resource (workspace, database, item, etc).","group":"Link","method":"POST","path":"/:resourceType/:resourceId/link","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_link","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"link":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string"},"resourcePath":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"resource":{}},"required":["resourceType","resourceId"],"additionalProperties":false}},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"url":{"type":"string"}},"required":["id","name","workspaceId","targetResourceType","targetResourceId","url"],"additionalProperties":false}},"required":["link"],"additionalProperties":false}}},{"key":"update-link","title":"Update link","description":"Update a link's name.","group":"Link","method":"PATCH","path":"/link/:linkId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_link","surface":"search"},"schemas":{"params":{"type":"object","properties":{"linkId":{"type":"string"}},"required":["linkId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"link":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string"},"resourcePath":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"resource":{}},"required":["resourceType","resourceId"],"additionalProperties":false}},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"url":{"type":"string"}},"required":["id","name","workspaceId","targetResourceType","targetResourceId","url"],"additionalProperties":false}},"required":["link"],"additionalProperties":false}}},{"key":"get-link","title":"Get link by id","description":"Returns a single link by id.","group":"Link","method":"GET","path":"/link/:linkId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_link_by_id","surface":"search"},"schemas":{"params":{"type":"object","properties":{"linkId":{"type":"string"}},"required":["linkId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"link":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string"},"resourcePath":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"resource":{}},"required":["resourceType","resourceId"],"additionalProperties":false}},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"url":{"type":"string"}},"required":["id","name","workspaceId","targetResourceType","targetResourceId","url"],"additionalProperties":false}},"required":["link"],"additionalProperties":false}}},{"key":"delete-link","title":"Delete link","description":"Soft-delete a link by id. DESTRUCTIVE.","group":"Link","method":"DELETE","path":"/link/:linkId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_link","surface":"search"},"schemas":{"params":{"type":"object","properties":{"linkId":{"type":"string"}},"required":["linkId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-links-by-workspace","title":"List links in a workspace","description":"Returns all links scoped to the given workspace.","group":"Link","method":"GET","path":"/workspace/:workspaceId/links","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_links_in_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string"},"resourcePath":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"resource":{}},"required":["resourceType","resourceId"],"additionalProperties":false}},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"url":{"type":"string"}},"required":["id","name","workspaceId","targetResourceType","targetResourceId","url"],"additionalProperties":false}}},"required":["links"],"additionalProperties":false}}},{"key":"get-links-in-resource","title":"List links targeting a resource","description":"Returns all links whose target is the given resource.","group":"Link","method":"GET","path":"/:resourceType/:resourceId/links","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_links_targeting_a_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string"},"resourcePath":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"resource":{}},"required":["resourceType","resourceId"],"additionalProperties":false}},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"targetResourceId":{"type":"string"},"url":{"type":"string"}},"required":["id","name","workspaceId","targetResourceType","targetResourceId","url"],"additionalProperties":false}}},"required":["links"],"additionalProperties":false}}},{"key":"list-deployment-versions","title":"List deployment versions","description":"Public changelog sidebar: published deployment versions with items.","group":"DeploymentVersion","method":"GET","path":"/deployment-versions/:appPlatformType","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]}},"required":["appPlatformType"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"deploymentVersions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]},"versionId":{"type":"string"},"friendlyVersionName":{"type":"string"},"title":{"type":"string"},"deprecatedAt":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"deploymentVersionItems":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"title":{"type":"string"},"position":{"type":"number"},"seenAt":{"type":["string","null"]}},"required":["id","iconNameType","title","position","seenAt"],"additionalProperties":false}},{"type":"null"}]}},"required":["id","appPlatformType","versionId","friendlyVersionName","title","deprecatedAt","publishedAt","deploymentVersionItems"],"additionalProperties":false}}},"required":["deploymentVersions"],"additionalProperties":false}}},{"key":"get-latest-deployment-version","title":"Get latest deployment version","description":"Public latest published deployment version for one app platform.","group":"DeploymentVersion","method":"GET","path":"/deployment-versions/app-platform/:appPlatformType/latest","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]}},"required":["appPlatformType"],"additionalProperties":false},"query":{"type":"object","properties":{"versionId":{"type":"string","minLength":1}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"deploymentVersion":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]},"versionId":{"type":"string"},"friendlyVersionName":{"type":"string"},"title":{"type":"string"},"deprecatedAt":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"deploymentVersionItems":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"title":{"type":"string"},"position":{"type":"number"},"seenAt":{"type":["string","null"]}},"required":["id","iconNameType","title","position","seenAt"],"additionalProperties":false}},{"type":"null"}]}},"required":["id","appPlatformType","versionId","friendlyVersionName","title","deprecatedAt","publishedAt","deploymentVersionItems"],"additionalProperties":false},{"type":"null"}]},"runningDeploymentVersion":{"anyOf":[{"$ref":"#/properties/deploymentVersion/anyOf/0"},{"type":"null"}]}},"required":["deploymentVersion","runningDeploymentVersion"],"additionalProperties":false}}},{"key":"list-deployment-version-item-blocks","title":"List deployment version item blocks","description":"Public changelog content blocks for a deployment version.","group":"DeploymentVersion","method":"GET","path":"/deployment-versions/:deploymentVersionId/blocks","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"deploymentVersionId":{"type":"string","minLength":1}},"required":["deploymentVersionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"deploymentVersionItemBlocks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"deploymentVersionItemId":{"type":"string"},"type":{"type":"string","enum":["markdown","image","video"]},"position":{"type":"number"},"payload":{"type":"object","properties":{"md":{"type":"string"},"src":{"type":"string"},"fileId":{"type":"string"},"file":{},"sizeType":{"type":"string","enum":["standard","content"]},"alignmentType":{"type":"string","enum":["top","bottom","left","right","center","none"]},"padding":{"type":"string","enum":["top","bottom","left","right","center","none"]},"fitType":{"type":"string","enum":["contain","cover"]},"fullWidth":{"type":"boolean"},"fullHeight":{"type":"boolean"},"ratio":{"type":"string"},"height":{"type":"string"},"scale":{"type":"number"},"alternateText":{"type":"string"},"caption":{"type":"string"},"autoplay":{"type":"boolean"},"useBuiltInPlayer":{"type":"boolean"}},"additionalProperties":true}},"required":["id","deploymentVersionItemId","type","position","payload"],"additionalProperties":false}}},"required":["deploymentVersionItemBlocks"],"additionalProperties":false}}},{"key":"publish-deployment-version","title":"Publish deployment version","description":"CI-only. Sets publishedAt to now for a pre-created version matching versionId and appPlatformType, then emits if needed.","group":"DeploymentVersion","method":"POST","path":"/deployment-versions/publish","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"versionId":{"type":"string","minLength":1},"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]}},"required":["versionId","appPlatformType"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"ingest-deployment-version","title":"Ingest deployment version","description":"CI-only. Creates a published deployment version with changelog items from commits. Idempotent on versionId + appPlatformType.","group":"DeploymentVersion","method":"POST","path":"/deployment-versions/ingest","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"versionId":{"type":"string","minLength":1},"friendlyVersionName":{"type":"string","minLength":1},"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]},"publishedAt":{"type":["string","null"]},"titleByLocaleType":{"type":"object","additionalProperties":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1},"description":{"type":["string","null"]}},"required":["title"],"additionalProperties":false}}},"required":["versionId","friendlyVersionName","appPlatformType","items"],"additionalProperties":false},"response":{"type":"object","properties":{"deploymentVersion":{"type":"object","properties":{"id":{"type":"string"},"appPlatformType":{"type":"string","enum":["mobile","web","desktop"]},"versionId":{"type":"string"},"friendlyVersionName":{"type":"string"},"title":{"type":"string"},"deprecatedAt":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"deploymentVersionItems":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"iconNameType":{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},"title":{"type":"string"},"position":{"type":"number"},"seenAt":{"type":["string","null"]}},"required":["id","iconNameType","title","position","seenAt"],"additionalProperties":false}},{"type":"null"}]}},"required":["id","appPlatformType","versionId","friendlyVersionName","title","deprecatedAt","publishedAt","deploymentVersionItems"],"additionalProperties":false},"created":{"type":"boolean"}},"required":["deploymentVersion","created"],"additionalProperties":false}}},{"key":"mark-deployment-version-item-seen","title":"Mark deployment version item seen","description":"Marks a changelog item as seen for the current entity.","group":"DeploymentVersion","method":"POST","path":"/deployment-version-items/:deploymentVersionItemId/seen","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"deploymentVersionItemId":{"type":"string","minLength":1}},"required":["deploymentVersionItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-workspace-members","title":"List workspace members","description":"Returns all users that are members of the given workspace, with their group memberships. Email addresses of other users are included only when the requester has workspaceAdmin or workspaceMemberAdmin permission.","group":"WorkspaceMember","method":"GET","path":"/workspace/:workspaceId/members","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_workspace_members","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"entity":{"type":"object","properties":{"entityType":{"type":"string","enum":["bot","user","system","guest","app","agent"]},"entityId":{"type":["string","null"]},"payload":{}},"required":["entityType","entityId"],"additionalProperties":false},"groupIds":{"type":"array","items":{"type":"string"}}},"required":["entity","groupIds"],"additionalProperties":false}}},"required":["members"],"additionalProperties":false}}},{"key":"get-members-count-by-workspace-ids","title":"Get member counts for multiple workspaces","description":"Returns member counts for the given list of workspaces. Each workspace is permission-checked individually for readWorkspace.","group":"WorkspaceMember","method":"POST","path":"/workspace/membersCount","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_member_counts_for_multiple_workspaces","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"workspaceIds":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["workspaceIds"],"additionalProperties":false},"response":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"workspaceId":{"type":"string"},"membersCount":{"type":"number"}},"required":["workspaceId","membersCount"],"additionalProperties":false}}},"required":["members"],"additionalProperties":false}}},{"key":"delete-workspace-member","title":"Delete a workspace member","description":"Removes a user from a workspace: revokes all permissions, removes from all groups, drops live socket subscriptions, and schedules a job to switch authored data to the substitute user. DESTRUCTIVE — refuses to delete the last admin.","group":"WorkspaceMember","method":"DELETE","path":"/workspace/:workspaceId/members/:userId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_a_workspace_member","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"userId":{"type":"string"}},"required":["workspaceId","userId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"substituteUserId":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-database-view","title":"Create database view","description":"Create a new view (table/board/calendar/etc.) on a database. Logs DatabaseViewCreated activity. Requires createDatabaseView permission on the database.","group":"DatabaseView","method":"POST","path":"/database/:databaseId/view","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_database_view","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string","minLength":1}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["table","map","form","timeline","calendar","kanban","iframe"]},"filterQuery":{},"position":{"type":"number"}},"required":["name","type"],"additionalProperties":false},"response":{"type":"object","properties":{"databaseView":{}},"additionalProperties":false}}},{"key":"get-database-views","title":"Get database views","description":"List all views in a database that the caller has read permission for. Filters by readDatabaseView per-resource permission.","group":"DatabaseView","method":"GET","path":"/database/:databaseId/views","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_views","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string","minLength":1}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["table","map","form","timeline","calendar","kanban","iframe"]},"filterQuery":{}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseViews":{"type":"array"}},"required":["databaseViews"],"additionalProperties":false}}},{"key":"get-database-view","title":"Get database view","description":"Get a single database view by id. Requires readDatabaseView permission on the view.","group":"DatabaseView","method":"GET","path":"/view/:databaseViewId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_database_view","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databaseView":{}},"additionalProperties":false}}},{"key":"update-database-view","title":"Update database view","description":"Update a database view. Handles type changes via the type-strategy factory, normalizes filter queries, and logs DatabaseViewUpdated activity. Requires updateDatabaseView permission (databaseViewAdmin for protected/isAutoSaveEnabled changes).","group":"DatabaseView","method":"PATCH","path":"/view/:databaseViewId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_view","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"type":{"type":"string","enum":["table","map","form","timeline","calendar","kanban","iframe"]},"filterQuery":{},"hiddenFilterQuery":{},"payload":{},"offset":{"type":"number"},"isAutoSaveEnabled":{"type":"boolean"},"isProtected":{"type":"boolean"},"isPublic":{"type":"boolean"},"sortedDatabasePropertyIds":{"type":"array","items":{"type":"string"}},"summaryConfig":{"type":"array"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-view","title":"Delete database view","description":"Delete a database view. Refuses to delete the last view, requires another Table-type view to remain, and re-points the database default view if needed. Logs DatabaseViewDeleted activity. Requires deleteDatabaseView permission.","group":"DatabaseView","method":"DELETE","path":"/view/:databaseViewId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_database_view","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"duplicate-database-view","title":"Duplicate database view","description":"Enqueue a DuplicateResourceJob to clone a database view. Returns the job id; the duplication runs asynchronously. Requires createDatabaseView permission on the parent database.","group":"DatabaseView","method":"POST","path":"/view/:databaseViewId/duplicate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Duplicate_database_view","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"filterQuery":{},"hiddenFilterQuery":{},"sortedDatabasePropertyIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"response":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false}}},{"key":"update-database-view-position","title":"Update database view position","description":"Move a view by an offset within the database. Acquires a per-database lock to keep ordering consistent. Logs a DatabaseViewPositionUpdated activity per affected view. Requires updateDatabaseView permission.","group":"DatabaseView","method":"PATCH","path":"/view/:databaseViewId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_database_view_position","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"offset":{"type":"number"}},"required":["offset"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"upload-database-view-payload-file","title":"Upload database view payload file","description":"Upload an image file referenced from a view payload (e.g. background image). Multipart upload - not supported through the typed adapter pipeline.","group":"DatabaseView","method":"POST","path":"/view/:databaseViewId/file","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseViewId":{"type":"string","minLength":1}},"required":["databaseViewId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"file":{}},"additionalProperties":false}}},{"key":"create-document","title":"Create document","description":"Create a new collaborative document inside a workspace. Content is empty on creation; fill it via Update document content or the collaboration WebSocket.","group":"Document","method":"POST","path":"/workspaces/:workspaceId/documents","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_document","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"iconNameType":{"type":"string"},"coverFileId":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"position":{"type":["number","null"]},"templateId":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"document":{}},"additionalProperties":false}}},{"key":"get-document","title":"Get document","description":"Read document metadata and the latest content snapshot. The snapshot is regenerated on every collaboration save and may lag the live state slightly.","group":"Document","method":"GET","path":"/documents/:documentId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_document","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"document":{}},"additionalProperties":false}}},{"key":"list-documents","title":"List documents","description":"List all non-archived documents in a workspace, filtered by the requesting entity's read permission.","group":"Document","method":"GET","path":"/workspaces/:workspaceId/documents","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_documents","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"archived":{"anyOf":[{"type":"string","const":"true"},{"type":"string","const":"false"},{"type":"boolean"}]},"templates":{"anyOf":[{"type":"string","const":"true"},{"type":"string","const":"false"},{"type":"boolean"}]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"documents":{"type":"array"}},"required":["documents"],"additionalProperties":false}}},{"key":"update-document-meta","title":"Update document meta","description":"Update document title, icon, or cover image. Document content (body) is edited through Update document content or the collaboration WebSocket.","group":"Document","method":"PATCH","path":"/documents/:documentId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_document_meta","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"iconNameType":{"type":["string","null"]},"iconEmoji":{"type":["string","null"]},"coverFileId":{"type":["string","null"]},"isLocked":{"type":"boolean"},"isTemplate":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"document":{}},"additionalProperties":false}}},{"key":"update-document-content","title":"Update document content","description":"Replace or append to the document body through REST. Accepts either contentSnapshot (ProseMirror JSON, same shape as returned by Get document) or contentText (plain text, each line becomes a paragraph). Live collaboration clients receive the change in real time. Permission: updateDocument (documentAdmin when the document is locked).","group":"Document","method":"PUT","path":"/documents/:documentId/content","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_document_content","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"contentSnapshot":{},"contentText":{"type":"string"},"mode":{"type":"string","enum":["replace","append"]}},"additionalProperties":false},"response":{"type":"object","properties":{"document":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"authorId":{"type":["string","null"]},"workspaceId":{"type":"string"},"coverFile":{"anyOf":[{},{"type":"null"}]},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"contentSnapshot":{"anyOf":[{},{"type":"null"}]},"snapshotUpdatedAt":{"type":["string","null"]},"isLocked":{"type":"boolean"},"isTemplate":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","title","authorId","workspaceId","iconNameType","iconEmoji","snapshotUpdatedAt","isLocked","isTemplate","createdAt","updatedAt"],"additionalProperties":false}},"required":["document"],"additionalProperties":false}}},{"key":"delete-document","title":"Delete document","description":"Archive a document (soft delete). Content remains accessible to admins via unarchive.","group":"Document","method":"DELETE","path":"/documents/:documentId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_document","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"restore-document","title":"Restore document","description":"Unarchive a previously soft-deleted document. Permission: documentAdmin.","group":"Document","method":"POST","path":"/documents/:documentId/restore","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Restore_document","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"document":{}},"additionalProperties":false}}},{"key":"get-document-backlinks","title":"Get document backlinks","description":"List documents in the same workspace that link back to this document via a sub-page card or a document mention. Result respects the requesting entity's read permissions.","group":"Document","method":"GET","path":"/documents/:documentId/backlinks","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_document_backlinks","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"documents":{"type":"array"}},"required":["documents"],"additionalProperties":false}}},{"key":"fetch-url-metadata","title":"Fetch URL metadata","description":"Server-side fetch of OG/Twitter meta tags for a URL — title, description, image, site name. Used by bookmark cards to show rich previews. Capped at 256KB body / 6s timeout.","group":"Document","method":"GET","path":"/documents/url-metadata","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"siteName":{"type":["string","null"]}},"required":["url","title","description","imageUrl","siteName"],"additionalProperties":false}}},{"key":"list-document-snapshots","title":"List document snapshots","description":"List version history snapshots for a document. Permission: readDocument. Snapshots are captured every 10th save (max 100 retained per document).","group":"Document","method":"GET","path":"/documents/:documentId/snapshots","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"snapshots":{"type":"array"}},"required":["snapshots"],"additionalProperties":false}}},{"key":"restore-document-snapshot","title":"Restore document snapshot","description":"Roll the live document state back to a previous snapshot's ydocState. Permission: documentAdmin. Connected clients reconcile via Y.applyUpdate.","group":"Document","method":"POST","path":"/documents/:documentId/snapshots/:snapshotId/restore","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"},"snapshotId":{"type":"string"}},"required":["documentId","snapshotId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"document":{}},"additionalProperties":false}}},{"key":"upload-document-file","title":"Upload file to document","description":"Upload an image or attachment (multipart/form-data, \"file\" field) and receive the persisted file entity. Returned URL is embeddable directly in the document body.","group":"Document","method":"POST","path":"/documents/:documentId/file","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"file":{}},"additionalProperties":false}}},{"key":"ask-document-ai","title":"Ask document AI","description":"Send a free-form prompt (with optional selected fragment) to the AI assistant. Returns a single-paragraph response suitable for inline insertion into the document. Permission: updateDocument.","group":"Document","method":"POST","path":"/documents/:documentId/ai-prompt","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Ask_document_AI","surface":"search"},"schemas":{"params":{"type":"object","properties":{"documentId":{"type":"string"}},"required":["documentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":8000},"selectedText":{"type":["string","null"]}},"required":["prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"response":{"type":"string"}},"required":["response"],"additionalProperties":false}}},{"key":"search-skills","title":"Search skills","description":"Find published skills the caller can read. A skill is a reusable, human-written procedure. Returns name, summary and the skill:// resource URI for each match — read that resource to get the full instructions. Use this first when the user asks to find or install a skill, then let the user pick before installing anything.","group":"Skill","method":"GET","path":"/skills/search","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Search_skills","surface":"search"},"schemas":{"params":null,"query":{"type":"object","properties":{"search":{"type":"string"},"workspaceId":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"skills":{"type":"array","items":{}}},"required":["skills"],"additionalProperties":false}}},{"key":"check-skill-updates","title":"Check skill updates","description":"Given the skills already installed locally (workspace name, skill name and installed version, all readable from the skill's frontmatter), report which ones have a newer published version and why it changed. Read-only: it never installs anything.","group":"Skill","method":"POST","path":"/skills/check-updates","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Check_skill_updates","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"installed":{"type":"array","items":{"type":"object","properties":{"workspaceName":{"type":"string"},"skillName":{"type":"string"},"version":{"type":"number"}},"required":["workspaceName","skillName","version"],"additionalProperties":false},"maxItems":200}},"required":["installed"],"additionalProperties":false},"response":{"type":"object","properties":{"updates":{"type":"array","items":{}}},"required":["updates"],"additionalProperties":false}}},{"key":"list-skills","title":"List skills","description":"List the skills in a workspace, including unpublished drafts the caller can read. Filtered by the caller's permissions.","group":"Skill","method":"GET","path":"/workspaces/:workspaceId/skills","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_skills","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":"string"},"publishedOnly":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"archived":{"$ref":"#/properties/publishedOnly"},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"type":"integer","minimum":0,"maximum":10000}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"skills":{"type":"array","items":{}},"hasMore":{"type":"boolean"}},"required":["skills","hasMore"],"additionalProperties":false}}},{"key":"create-skill","title":"Create skill","description":"Create a skill in a workspace. Instructions are markdown and become the body of SKILL.md; the name is a slug, derived from the title when omitted. A new skill starts unpublished, so it stays invisible to other people until it is published.","group":"Skill","method":"POST","path":"/workspaces/:workspaceId/skills","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":1536},"instructions":{"type":"string","maxLength":200000},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":20},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"position":{"type":["number","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"skill":{}},"additionalProperties":false}}},{"key":"import-skill","title":"Import skill","description":"Create a skill from the contents of a SKILL.md file. Frontmatter name and description are read when present, and the rest of the file becomes the instructions. The imported skill starts unpublished.","group":"Skill","method":"POST","path":"/workspaces/:workspaceId/skills/import","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Import_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":200000},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"position":{"type":["number","null"]},"isPublic":{"type":"boolean"}},"required":["content"],"additionalProperties":false},"response":{"type":"object","properties":{"skill":{}},"additionalProperties":false}}},{"key":"generate-skill","title":"Generate skill","description":"Draft new skills from a plain-language description of the procedure. The model writes the title, the when-to-use summary, markdown instructions and tags for each one; ask for several separate procedures and each becomes its own skill. Every result is saved as an unpublished draft for a human to review and publish.","group":"Skill","method":"POST","path":"/workspaces/:workspaceId/skills/generate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":3,"maxLength":2000},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"position":{"type":["number","null"]},"isPublic":{"type":"boolean"}},"required":["prompt"],"additionalProperties":false},"response":{"type":"object","properties":{"skills":{}},"additionalProperties":false}}},{"key":"get-skill","title":"Get skill","description":"Read one skill by id, including its working draft and the currently published version.","group":"Skill","method":"GET","path":"/skills/:skillId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"skillId":{"type":"string"}},"required":["skillId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"skill":{},"publishedVersion":{}},"additionalProperties":false}}},{"key":"update-skill","title":"Update skill","description":"Edit a skill draft — name, title, description, markdown instructions or tags. Edits do not reach other people until the skill is published again. Permission: updateSkill.","group":"Skill","method":"PATCH","path":"/skills/:skillId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"skillId":{"type":"string"}},"required":["skillId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":1536},"instructions":{"type":"string","maxLength":200000},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":20}},"additionalProperties":false},"response":{"type":"object","properties":{"skill":{}},"additionalProperties":false}}},{"key":"publish-skill","title":"Publish skill","description":"Publish the current draft as the next version, optionally with a one-line note on what changed. Only published versions are visible to other people and to their AI clients. Permission: publishSkill.","group":"Skill","method":"POST","path":"/skills/:skillId/publish","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Publish_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"skillId":{"type":"string"}},"required":["skillId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"changelog":{"type":"string","maxLength":500}},"additionalProperties":false},"response":{"type":"object","properties":{"skill":{}},"additionalProperties":false}}},{"key":"unarchive-skill","title":"Restore skill","description":"Bring back a skill that was archived. Permission: deleteSkill.","group":"Skill","method":"POST","path":"/skills/:skillId/unarchive","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Restore_skill","surface":"search"},"schemas":{"params":{"type":"object","properties":{"skillId":{"type":"string"}},"required":["skillId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"skill":{}},"additionalProperties":false}}},{"key":"delete-skill","title":"Delete skill","description":"Archive a skill (soft delete). Already installed local copies are unaffected. Permission: deleteSkill.","group":"Skill","method":"DELETE","path":"/skills/:skillId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"skillId":{"type":"string"}},"required":["skillId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"list-agents","title":"List agents","description":"List the agents in a workspace.","group":"Agent","method":"GET","path":"/workspaces/:workspaceId/agents","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"publishedOnly":{"type":"string","enum":["true","false"]},"search":{"type":"string"},"limit":{"type":"string"},"offset":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"agents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["agents","hasMore"],"additionalProperties":false}}},{"key":"create-agent","title":"Create agent","description":"Create an agent in a workspace.","group":"Agent","method":"POST","path":"/workspaces/:workspaceId/agents","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":1536},"instructions":{"type":"string","maxLength":200000},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":20},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"position":{"type":["number","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}},"required":["agent"],"additionalProperties":false}}},{"key":"list-mentionable-agents","title":"List mentionable agents","description":"List published agents the caller can mention in the workspace.","group":"Agent","method":"GET","path":"/workspaces/:workspaceId/agents/mentionable","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"search":{"type":"string"},"limit":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"agents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}}},"required":["agents"],"additionalProperties":false}}},{"key":"get-agent","title":"Get agent","description":"Read one agent by id.","group":"Agent","method":"GET","path":"/agents/:agentId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false},"publishedVersion":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"agentId":{"type":"string"},"version":{"type":"number"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"changelog":{"type":["string","null"]},"publishedById":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"modelKey":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","agentId","version","name","title","description","instructions","tags","changelog","publishedById","toolNames","skillIds","subAgentIds","modelKey","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["agent","publishedVersion"],"additionalProperties":false}}},{"key":"update-agent","title":"Update agent","description":"Edit an agent draft.","group":"Agent","method":"PATCH","path":"/agents/:agentId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":1536},"instructions":{"type":"string","maxLength":200000},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":20},"icon":{"type":"object","properties":{"iconNameType":{"type":["string","null"]},"iconEmoji":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}]}},"additionalProperties":false},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"},"maxItems":20},"subAgentIds":{"type":"array","items":{"type":"string"},"maxItems":10}},"additionalProperties":false},"response":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}},"required":["agent"],"additionalProperties":false}}},{"key":"publish-agent","title":"Publish agent","description":"Publish the current agent draft as the next version.","group":"Agent","method":"POST","path":"/agents/:agentId/publish","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"changelog":{"type":"string","maxLength":512}},"additionalProperties":false},"response":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}},"required":["agent"],"additionalProperties":false}}},{"key":"unarchive-agent","title":"Restore agent","description":"Bring back an agent that was archived.","group":"Agent","method":"POST","path":"/agents/:agentId/unarchive","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":"string"},"instructions":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"authorId":{"type":["string","null"]},"author":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nick":{"type":"string"}},"required":["id","nick"],"additionalProperties":false},{"type":"null"}]},"workspaceId":{"type":"string"},"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]},"iconEmoji":{"type":["string","null"]},"modelKey":{"type":["string","null"]},"toolNames":{"type":"array","items":{"type":"string"}},"skillIds":{"type":"array","items":{"type":"string"}},"subAgentIds":{"type":"array","items":{"type":"string"}},"publishedVersion":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"hasUnpublishedChanges":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","title","description","instructions","tags","authorId","author","workspaceId","iconNameType","iconEmoji","modelKey","toolNames","skillIds","subAgentIds","publishedVersion","publishedAt","hasUnpublishedChanges","createdAt","updatedAt"],"additionalProperties":false}},"required":["agent"],"additionalProperties":false}}},{"key":"delete-agent","title":"Delete agent","description":"Archive an agent (soft delete).","group":"Agent","method":"DELETE","path":"/agents/:agentId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"list-agent-runs","title":"List agent runs","description":"List runs for an agent.","group":"Agent","method":"GET","path":"/agents/:agentId/runs","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":{"type":"object","properties":{"limit":{"type":"string"},"offset":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"agentId":{"type":"string"},"workspaceId":{"type":"string"},"publishedVersion":{"type":["number","null"]},"state":{"type":"string","enum":["pending","running","completed","failed","cancelled"]},"triggerType":{"type":"string","enum":["mention","cron","spawn","panel"]},"triggerTypePayload":{},"actorEntityType":{"anyOf":[{"type":"string","enum":["bot","user","system","guest","app","agent"]},{"type":"null"}]},"actorEntityId":{"type":["string","null"]},"error":{"type":["string","null"]},"duration":{"type":["number","null"]},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"inputTokens":{"type":"number"},"outputTokens":{"type":"number"},"totalTokens":{"type":"number"},"toolCallCount":{"type":"number"},"spawnDepth":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","agentId","workspaceId","publishedVersion","state","triggerType","actorEntityType","actorEntityId","error","duration","startedAt","finishedAt","inputTokens","outputTokens","totalTokens","toolCallCount","spawnDepth","createdAt","updatedAt"],"additionalProperties":false}}},"required":["runs"],"additionalProperties":false}}},{"key":"list-agent-crons","title":"List agent crons","description":"List scheduled cron tasks attached to an agent.","group":"Agent","method":"GET","path":"/agents/:agentId/crons","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"crons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"agentId":{"type":"string"},"cronId":{"type":"string"},"workspaceId":{"type":"string"},"taskPrompt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","agentId","cronId","workspaceId","taskPrompt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["crons"],"additionalProperties":false}}},{"key":"create-agent-cron","title":"Create agent cron","description":"Attach a workspace cron to an agent with a task prompt.","group":"Agent","method":"POST","path":"/agents/:agentId/crons","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"}},"required":["agentId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"cronId":{"type":"string","minLength":1},"taskPrompt":{"type":"string","minLength":1,"maxLength":10000}},"required":["cronId","taskPrompt"],"additionalProperties":false},"response":{"type":"object","properties":{"cron":{"type":"object","properties":{"id":{"type":"string"},"agentId":{"type":"string"},"cronId":{"type":"string"},"workspaceId":{"type":"string"},"taskPrompt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","agentId","cronId","workspaceId","taskPrompt","createdAt","updatedAt"],"additionalProperties":false}},"required":["cron"],"additionalProperties":false}}},{"key":"delete-agent-cron","title":"Delete agent cron","description":"Detach a scheduled cron task from an agent.","group":"Agent","method":"DELETE","path":"/agents/:agentId/crons/:agentCronId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"agentId":{"type":"string"},"agentCronId":{"type":"string"}},"required":["agentId","agentCronId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-llm-models","title":"Get LLM models","description":"List available LLM models that can be used in formula LLM() calls. Returns enabled models sorted by recommended order.","group":"LlmModel","method":"GET","path":"/llm-models","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_LLM_models","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"llmModels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"llmProviderType":{"type":"string"},"description":{"type":["string","null"]},"family":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"contextWindow":{"type":"number"},"maxOutputTokens":{"type":"number"},"costTier":{"type":"number"},"speedTier":{"type":"number"},"isRecommended":{"type":"boolean"},"sortOrder":{"type":"number"}},"required":["id","key","name","llmProviderType","description","family","capabilities","contextWindow","maxOutputTokens","costTier","speedTier","isRecommended","sortOrder"],"additionalProperties":false}}},"required":["llmModels"],"additionalProperties":false}}},{"key":"add-message-reaction","title":"Add message reaction","description":"Add an emoji reaction to a message. Idempotent — adding the same emoji twice from the same entity is a no-op.","group":"MessageReaction","method":"POST","path":"/messages/:messageId/reactions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Add_message_reaction","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"emoji":{"type":"string","minLength":1,"maxLength":64}},"required":["emoji"],"additionalProperties":false},"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"remove-message-reaction","title":"Remove message reaction","description":"Remove the calling entity's reaction with the given emoji from a message.","group":"MessageReaction","method":"DELETE","path":"/messages/:messageId/reactions/:emoji","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Remove_message_reaction","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"},"emoji":{"type":"string","minLength":1,"maxLength":64}},"required":["messageId","emoji"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"get-message-reactions","title":"Get message reactions","description":"List reactions on a message paginated by reaction _id (cursor). Filter with includedEmojis or excludedEmojis (CSV or array).","group":"MessageReaction","method":"GET","path":"/messages/:messageId/reactions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_message_reactions","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":{"type":"object","properties":{"cursor":{"type":["string","null"]},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20},"includedEmojis":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]},"excludedEmojis":{"$ref":"#/properties/includedEmojis"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"reactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"messageId":{"type":"string"},"entityType":{"type":"string"},"entityId":{"type":"string"},"emoji":{"type":"string"},"entity":{"anyOf":[{},{"type":"null"}]}},"required":["id","messageId","entityType","entityId","emoji"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["reactions","nextCursor"],"additionalProperties":false}}},{"key":"get-latest-native-app","title":"Get latest native app","description":"Resolve the latest native app download URL for a given operating system. Reads the platform-specific YAML manifest from the configured AWS endpoint, parses it, and returns the encoded download URL plus the file name. Throws NotFound if the manifest is missing/unreachable. No auth required.","group":"NativeApp","method":"GET","path":"/native-app/latest/:operatingSystemType","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"operatingSystemType":{"type":"string","enum":["win","mac","linux","android","ios"]}},"required":["operatingSystemType"],"additionalProperties":false},"query":{"type":"object","properties":{"architecture":{"type":"string","enum":["x64","arm64"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"nativeApp":{}},"additionalProperties":false}}},{"key":"get-system-messages","title":"Get system messages","description":"Returns the currently-relevant, non-acknowledged system messages for the calling user (at most 10), in their locale, serious-priority notices first and then by most recent publishedAt (falling back to createdAt). Non-User callers receive an empty list. Filters out unpublished or expired messages and, except for serious-priority notices, messages published before the user account was created.","group":"SystemMessage","method":"GET","path":"/system-messages","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"systemMessages":{"type":"array","items":{}}},"required":["systemMessages"],"additionalProperties":false}}},{"key":"acknowledge-system-message","title":"Acknowledge system message","description":"Marks a system message as acknowledged for the calling user (upsert into SystemMessageUser, clearing any prior soft-delete). No-op for non-User callers.","group":"SystemMessage","method":"POST","path":"/system-messages/:systemMessageId/acknowledge","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"systemMessageId":{"type":"string"}},"required":["systemMessageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"acknowledge-system-messages","title":"Acknowledge system messages","description":"Marks several system messages as acknowledged for the calling user in one request (upsert into SystemMessageUser, clearing any prior soft-delete). No-op for non-User callers.","group":"SystemMessage","method":"POST","path":"/system-messages/acknowledge","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"systemMessageIds":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$"},"minItems":1,"maxItems":10}},"required":["systemMessageIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-cron","title":"Create cron","description":"Create a cron schedule in a workspace. Validates the cronExpression with cron-parser and computes nextRunAt. Requires createCron permission. Registers the cron as a ResourceItem under the workspace. A cron stays armed only while a runnable version of an enabled automation uses it; otherwise it is disabled automatically and re-armed when an automation using it is saved.","group":"Cron","method":"POST","path":"/workspace/:workspaceId/cron","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_cron","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"cronExpression":{"type":"string","minLength":1}},"required":["name","cronExpression"],"additionalProperties":false},"response":{"type":"object","properties":{"cron":{}},"additionalProperties":false}}},{"key":"get-crons","title":"Get crons","description":"List all cron schedules in a workspace. Requires readCron permission.","group":"Cron","method":"GET","path":"/workspace/:workspaceId/crons","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_crons","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"crons":{"type":"array","items":{}}},"required":["crons"],"additionalProperties":false}}},{"key":"update-cron","title":"Update cron","description":"Partially update name/cronExpression/isEnabled on an existing cron. Requires updateCron permission. Recomputes nextRunAt when the expression changes, and when re-enabling a cron so a stale schedule does not fire immediately. Returns 404 Cron not found for a missing cron.","group":"Cron","method":"PUT","path":"/cron/:cronId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_cron","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cronId":{"type":"string"}},"required":["cronId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"cronExpression":{"type":"string","minLength":1},"isEnabled":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-cron","title":"Delete cron","description":"Delete a cron schedule by id. Requires deleteCron permission. Throws NotFound when the cron is missing.","group":"Cron","method":"DELETE","path":"/cron/:cronId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_cron","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cronId":{"type":"string"}},"required":["cronId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-call-access-token","title":"Get call access token","description":"Resolve or create a Call for the given conversation type/payload, ensure a LiveKit room, and return a short-lived access token. On first creation: posts a Call message to the conversation, dispatches CallInviteCreated socket events to all members with read access (excluding the requester), and runs the conversation type strategy `afterCallCreated` hook.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{}},"additionalProperties":false},"response":{"type":"object","properties":{"call":{},"accessToken":{"type":"string"}},"required":["accessToken"],"additionalProperties":false}}},{"key":"get-active-call","title":"Get active call","description":"Return the currently active (not ended) Call for the given conversation type/payload, or null when no call is ongoing. Does not create anything; used by pre-join screens to show who is already in the call.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/active","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{}},"additionalProperties":false},"response":{"type":"object","properties":{"call":{}},"additionalProperties":false}}},{"key":"create-call-invites","title":"Create call invites","description":"Ring selected users into the ongoing call of the given conversation. The requester must be a participant of the LiveKit room. Users without read access to the conversation resource, already ringing, or already in the room are skipped. Dispatches CallInviteCreated socket events to the invited users.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/invite","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"userIds":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["userIds"],"additionalProperties":false},"response":{"type":"object","properties":{"invitedUserIds":{"type":"array","items":{"type":"string"}}},"required":["invitedUserIds"],"additionalProperties":false}}},{"key":"mute-call-participant","title":"Mute call participant","description":"Server-side mute (or unmute) of a participant's published track in the LiveKit room of the given conversation, enforced via the LiveKit admin API. The requester must have access to the conversation.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/mute","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"targetIdentity":{"type":"string"},"trackSid":{"type":"string"},"muted":{"type":"boolean"}},"required":["targetIdentity","trackSid","muted"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"remove-call-participant","title":"Remove call participant","description":"Forcibly removes a participant from the LiveKit room of the given conversation, enforced via the LiveKit admin API. The requester must be a participant of the same room and cannot remove themselves.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/remove-participant","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"targetIdentity":{"type":"string"}},"required":["targetIdentity"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"set-call-agent-enabled","title":"Set call agent enabled","description":"Turns the AI call agent on or off for the ongoing call of the given conversation. Turning it off removes the agent participant from the LiveKit room and stops it from rejoining when somebody else connects; turning it on schedules the agent to join again. The requester must be a participant of the room.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/agent","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"isEnabled":{"type":"boolean"}},"required":["isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{"isAgentEnabled":{"type":"boolean"}},"required":["isAgentEnabled"],"additionalProperties":false}}},{"key":"set-call-recording","title":"Set call recording","description":"Starts or stops the LiveKit Egress recording of the ongoing call for the given conversation. Requires the recording configuration (S3 target) to be present, otherwise the endpoint reports the feature as unavailable. The finished file is ingested into the conversation once LiveKit reports the egress as ended. The requester must be a participant of the room.","group":"Call","method":"POST","path":"/conversation-type/:conversationType/call/recording","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"isRecording":{"type":"boolean"}},"required":["isRecording"],"additionalProperties":false},"response":{"type":"object","properties":{"isRecording":{"type":"boolean"}},"required":["isRecording"],"additionalProperties":false}}},{"key":"get-automation-runs","title":"Get automation runs","description":"List automation runs for a given automation, paginated by offset/limit (newest first).","group":"AutomationRun","method":"GET","path":"/automation/:automationId/runs","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_runs","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["offset","limit"],"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"automationRuns":{"type":"array","items":{}}},"required":["automationRuns"],"additionalProperties":false}}},{"key":"process-pending-automation-runs","title":"Process pending automation runs","description":"Flip all ReceivedWhileOffline runs of an automation to either Skipped (when shouldSkip=true) or Pending. For Pending, also re-triggers each run via AutomationTriggerService.triggerExistingAutomationRun.","group":"AutomationRun","method":"PUT","path":"/automation/:automationId/process-pending-runs","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Process_pending_automation_runs","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"shouldSkip":{"type":"boolean"}},"required":["shouldSkip"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-automation-connection-callback","title":"Get automation connection callback","description":"Read the status/result of a pending OAuth callback record. Caller must be a User entity and must own the callback (userId match), otherwise Forbidden.","group":"AutomationConnectionCallback","method":"GET","path":"/automation-connection-callback/:automationConnectionCallbackId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"automationConnectionCallbackId":{"type":"string"}},"required":["automationConnectionCallbackId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationConnectionCallback":{}},"additionalProperties":false}}},{"key":"get-automation-versions","title":"Get automation versions","description":"List automation versions for a given automation, paginated by offset/limit (newest first), with author entity populated. Optional includeContent must be a boolean (true/false/1/0) — anything else is a 400; the listed versions never embed content.","group":"AutomationVersion","method":"GET","path":"/automation/:automationId/versions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_versions","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":{"type":"object","properties":{"includeContent":{"type":["boolean","string"]},"offset":{"type":"number","minimum":0},"limit":{"type":"number","minimum":1,"maximum":100}},"required":["offset","limit"],"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"automationVersions":{"type":"array","items":{}}},"required":["automationVersions"],"additionalProperties":false}}},{"key":"update-automation-version-status","title":"Update automation version status","description":"Set an automation version status. The body only accepts Inactive — any other status is rejected as an invalid request. If the version was the automation's currently-debugged version, debuggedAutomationVersionId is cleared and an AutomationUpdated activity is logged. Crons no other runnable version uses are disabled.","group":"AutomationVersion","method":"PUT","path":"/automation-version/:automationVersionId/status","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_automation_version_status","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationVersionId":{"type":"string"}},"required":["automationVersionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"status":{"type":"string","const":"inactive"}},"required":["status"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-dynamic-field-definition","title":"Create dynamic field definition","description":"Create a dynamic field definition for an app.","group":"DynamicFieldDefinition","method":"POST","path":"/app/:appId/dynamic-field-definition","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_dynamic_field_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"dynamicFieldDefinition":{}},"additionalProperties":false}}},{"key":"get-dynamic-field-definitions","title":"Get dynamic field definitions","description":"List all dynamic field definitions for an app.","group":"DynamicFieldDefinition","method":"GET","path":"/app/:appId/dynamic-field-definitions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_dynamic_field_definitions","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"dynamicFieldDefinitions":{"type":"array","items":{}}},"required":["dynamicFieldDefinitions"],"additionalProperties":false}}},{"key":"get-dynamic-field-definition-values","title":"Get dynamic field definition values","description":"Resolve the available value items for a dynamic field definition given a partial set of option inputs. Returns an empty list shape on failure via thrown ApiException.","group":"DynamicFieldDefinition","method":"POST","path":"/dynamic-field-definition/:dynamicFieldDefinitionId/values","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_dynamic_field_definition_values","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dynamicFieldDefinitionId":{"type":"string"}},"required":["dynamicFieldDefinitionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partialOptions":{"type":"object","additionalProperties":{}}},"required":["partialOptions"],"additionalProperties":false},"response":{"type":"object","properties":{"valueItems":{"type":"array","items":{}}},"required":["valueItems"],"additionalProperties":false}}},{"key":"delete-dynamic-field-definition","title":"Delete dynamic field definition","description":"Delete a dynamic field definition.","group":"DynamicFieldDefinition","method":"DELETE","path":"/dynamic-field-definition/:dynamicFieldDefinitionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_dynamic_field_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dynamicFieldDefinitionId":{"type":"string"}},"required":["dynamicFieldDefinitionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-connection","title":"Create connection","description":"Create an OAuth/credential connection in a workspace from a connection definition. Runs testConnection first; if it fails the entire create is rejected with the strategy-provided errorMessage. The avatar URL returned by the test (if any) is mirrored into FileStorage.","group":"Connection","method":"POST","path":"/workspace/:workspaceId/connection","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_connection","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"connectionDefinitionId":{"type":"string"},"options":{"type":"object","additionalProperties":{}}},"required":["connectionDefinitionId","options"],"additionalProperties":false},"response":{"type":"object","properties":{"connection":{}},"additionalProperties":false}}},{"key":"get-connections","title":"Get connections","description":"List all connections in a workspace.","group":"Connection","method":"GET","path":"/workspace/:workspaceId/connections","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_connections","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"connections":{}},"additionalProperties":false}}},{"key":"get-connection","title":"Get connection","description":"Fetch a single connection by id.","group":"Connection","method":"GET","path":"/workspace/:workspaceId/connection/:connectionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_connection","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"connectionId":{"type":"string"}},"required":["workspaceId","connectionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"connection":{}},"additionalProperties":false}}},{"key":"delete-connection","title":"Delete connection","description":"Permanently delete a connection. Confirm before calling — automations referencing this connection will start failing.","group":"Connection","method":"DELETE","path":"/workspace/:workspaceId/connection/:connectionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_connection","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"connectionId":{"type":"string"}},"required":["workspaceId","connectionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"content":{}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-connection","title":"Update connection","description":"Update connection name, connectionDefinitionId, or options. If options are provided, runs testConnection again before saving and refreshes the cached account/avatar metadata.","group":"Connection","method":"PUT","path":"/workspace/:workspaceId/connection/:connectionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_connection","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"connectionId":{"type":"string"}},"required":["workspaceId","connectionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"connectionDefinitionId":{"type":"string"},"options":{"type":"object","additionalProperties":{}}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-is-resource-watched-by-current-user","title":"Get is resource watched by current user","description":"Returns whether the calling user is watching (subscribed to update notifications for) the given resource.","group":"ResourceWatcher","method":"GET","path":"/resource/:resourceType/:resourceId/watch","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_is_resource_watched_by_current_user","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"isWatched":{"type":"boolean"}},"required":["isWatched"],"additionalProperties":false}}},{"key":"toggle-watch-for-resource","title":"Toggle watch for resource","description":"Subscribe or unsubscribe the calling user to update notifications for a resource. Emits ResourceWatchToggled socket event to the user room.","group":"ResourceWatcher","method":"POST","path":"/resource/:resourceType/:resourceId/watch","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Toggle_watch_for_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"setWatching":{"type":"boolean"}},"required":["setWatching"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-notifications","title":"Get notifications","description":"List the current user's notifications. Supports notificationFilterType (All/Unread/Unseen/Mentions/AssignedToMe), offset, limit. Notifications with the same aggregationKey+type are folded into one row with unreadGroupCount.","group":"Notification","method":"GET","path":"/notifications","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_notifications","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":{"type":"object","properties":{"notificationFilterType":{"type":"string","enum":["all","unread","mentions","assignedToMe","unseen"]},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"notifications":{}},"additionalProperties":false}}},{"key":"get-notifications-for-resource","title":"Get notifications scoped to a resource","description":"Same as get-notifications but scoped to a specific (resourceType, resourceId) — useful for showing the notification badge inside a single resource.","group":"Notification","method":"GET","path":"/resource/:resourceType/:resourceId/notifications","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_notifications_scoped_to_a_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":{"type":"object","properties":{"notificationFilterType":{"type":"string","enum":["all","unread","mentions","assignedToMe","unseen"]},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"notifications":{}},"additionalProperties":false}}},{"key":"get-unseen-notifications-count","title":"Get unseen notifications count","description":"Count of unseen + still-pending notifications for the current user (after aggregationKey grouping).","group":"Notification","method":"GET","path":"/notifications/count","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_unseen_notifications_count","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"count":{"type":"number"}},"required":["count"],"additionalProperties":false}}},{"key":"get-notification","title":"Get notification","description":"Fetch a single notification by id (must belong to the current user).","group":"Notification","method":"GET","path":"/notifications/:notificationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_notification","surface":"search"},"schemas":{"params":{"type":"object","properties":{"notificationId":{"type":"string"}},"required":["notificationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"notification":{}},"additionalProperties":false}}},{"key":"get-notification-group-events","title":"Get notification group events","description":"List the individual events that were folded into a grouped notification (newest first). The notification must belong to the current user; a non-group notification returns an empty list.","group":"Notification","method":"GET","path":"/notifications/:notificationId/events","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_notification_group_events","surface":"search"},"schemas":{"params":{"type":"object","properties":{"notificationId":{"type":"string"}},"required":["notificationId"],"additionalProperties":false},"query":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"events":{"type":"array","items":{}}},"required":["events"],"additionalProperties":false}}},{"key":"get-unseen-notifications-count-for-resource","title":"Get unseen notifications count for resource","description":"Same as get-unseen-notifications-count but scoped to (resourceType, resourceId).","group":"Notification","method":"GET","path":"/resource/:resourceType/:resourceId/notifications/count","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_unseen_notifications_count_for_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"count":{"type":"number"}},"required":["count"],"additionalProperties":false}}},{"key":"get-unread-notification-types-count","title":"Get unread notifications count by type","description":"Per-type unread counts (Unread/Unseen/Mentions/AssignedToMe). Returns a map keyed on NotificationFilterType.","group":"Notification","method":"GET","path":"/notifications/unread/count","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_unread_notifications_count_by_type","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"get-unread-notification-types-count-for-resource","title":"Get unread notifications count by type for resource","description":"Same as get-unread-notification-types-count but scoped to (resourceType, resourceId). Each count stops at 100, so 100 means 100 or more.","group":"Notification","method":"GET","path":"/resource/:resourceType/:resourceId/notifications/unread/count","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_unread_notifications_count_by_type_for_resou","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"update-notification","title":"Update notification (mark seen / read)","description":"Set readAt and/or seenAt on a single notification. Emits NotificationRead and NotificationUpdated socket events.","group":"Notification","method":"PATCH","path":"/notifications/:notificationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_notification_mark_seen_read","surface":"search"},"schemas":{"params":{"type":"object","properties":{"notificationId":{"type":"string"}},"required":["notificationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"seenAt":{"type":["string","null"]},"readAt":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-notification-group","title":"Update notification group","description":"Set readAt and/or seenAt on every notification in the same aggregationKey+type group. Emits NotificationGroupUpdated socket event.","group":"Notification","method":"PATCH","path":"/notifications/:notificationId/group","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_notification_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"notificationId":{"type":"string"}},"required":["notificationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"seenAt":{"type":["string","null"]},"readAt":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"set-all-user-notifications-seen","title":"Mark all notifications as seen","description":"Bulk-set seenAt on all unseen notifications for the current user. Emits NotificationsSeen socket event with the modified count.","group":"Notification","method":"POST","path":"/notifications/seen","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_all_notifications_as_seen","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"set-all-user-notifications-seen-for-resource","title":"Mark all notifications as seen for resource","description":"Same as set-all-user-notifications-seen but scoped to (resourceType, resourceId).","group":"Notification","method":"POST","path":"/resource/:resourceType/:resourceId/notifications/seen","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_all_notifications_as_seen_for_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"set-all-user-notifications-read","title":"Mark all notifications as read","description":"Bulk-set readAt on all unread notifications for the current user, optionally narrowed by notificationFilterType (Mentions/AssignedToMe). Emits NotificationsRead socket event.","group":"Notification","method":"POST","path":"/notifications/read","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_all_notifications_as_read","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"notificationFilterType":{"type":"string","enum":["all","unread","mentions","assignedToMe","unseen"]}},"additionalProperties":false},"response":{"type":"object","properties":{"readNotificationsCount":{"type":"number"}},"required":["readNotificationsCount"],"additionalProperties":false}}},{"key":"set-all-user-notifications-read-for-resource","title":"Mark all notifications as read for resource","description":"Same as set-all-user-notifications-read but scoped to (resourceType, resourceId).","group":"Notification","method":"POST","path":"/resource/:resourceType/:resourceId/notifications/read","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_all_notifications_as_read_for_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"notificationFilterType":{"type":"string","enum":["all","unread","mentions","assignedToMe","unseen"]}},"additionalProperties":false},"response":{"type":"object","properties":{"readNotificationsCount":{"type":"number"}},"required":["readNotificationsCount"],"additionalProperties":false}}},{"key":"create-file-cloud-item","title":"Upload file cloud item","description":"Multipart file upload into a cloud folder. NOT exposed to MCP — multipart streaming bypasses the typed Zod pipeline; the legacy upload route is the supported path.","group":"CloudItem","method":"POST","path":"/folder/:folderId/file","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string"}},"required":["folderId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"parentCloudItemId":{"type":"string"},"relativePath":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"cloudItem":{}},"additionalProperties":false}}},{"key":"create-folder-cloud-item","title":"Create folder cloud item","description":"Create a sub-folder (Catalog) inside a cloud folder. Optional parentCloudItemId nests the new folder inside an existing Catalog cloud item.","group":"CloudItem","method":"POST","path":"/folder/:folderId/catalog","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_folder_cloud_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string"}},"required":["folderId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"parentCloudItemId":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"cloudItem":{}},"additionalProperties":false}}},{"key":"get-cloud-items","title":"List cloud items","description":"List cloud items inside a folder, optionally scoped to a parentCloudItemId catalog. Supports search, sort (createdAt/size/name/type), sortDirection, and offset/limit pagination.","group":"CloudItem","method":"GET","path":"/folder/:folderId/items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_cloud_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string"}},"required":["folderId"],"additionalProperties":false},"query":{"type":"object","properties":{"parentCloudItemId":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"search":{"type":["string","null"]},"sort":{"type":"string","enum":["name","createdAt","size","type"]},"sortDirection":{"type":"string","enum":["asc","desc"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"cloudItems":{}},"additionalProperties":false}}},{"key":"get-cloud-item","title":"Get cloud item","description":"Fetch a single cloud item with the chain of parent catalogs leading up to it.","group":"CloudItem","method":"GET","path":"/cloud-item/:cloudItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_cloud_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cloudItemId":{"type":"string"}},"required":["cloudItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"cloudItem":{},"parentCloudItems":{}},"additionalProperties":false}}},{"key":"update-cloud-item-name","title":"Rename cloud item","description":"Rename a cloud item by id.","group":"CloudItem","method":"PUT","path":"/cloud-item/:cloudItemId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_cloud_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cloudItemId":{"type":"string"}},"required":["cloudItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-cloud-item-parent","title":"Move cloud item","description":"Reparent a cloud item under a new parent catalog (or to the folder root if parentCloudItemId equals the enclosing folderId).","group":"CloudItem","method":"PUT","path":"/cloud-item/:cloudItemId/parent-cloud-item-id","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Move_cloud_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cloudItemId":{"type":"string"}},"required":["cloudItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"parentCloudItemId":{"type":["string","null"]}},"required":["parentCloudItemId"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-cloud-item","title":"Delete cloud item","description":"Soft-delete a cloud item. Only the original author may delete the item. Confirm before calling.","group":"CloudItem","method":"DELETE","path":"/cloud-item/:cloudItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_cloud_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"cloudItemId":{"type":"string"}},"required":["cloudItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-cloud-items","title":"Delete cloud items","description":"Soft-delete several cloud items of one folder at once. Only items authored by the requester are deleted; the response lists the ids that were actually deleted. Confirm before calling.","group":"CloudItem","method":"DELETE","path":"/folder/:folderId/cloud-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_cloud_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"folderId":{"type":"string"}},"required":["folderId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"cloudItemIds":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$"},"minItems":1,"maxItems":500}},"required":["cloudItemIds"],"additionalProperties":false},"response":{"type":"object","properties":{"deletedCloudItemIds":{"type":"array","items":{"type":"string"}}},"required":["deletedCloudItemIds"],"additionalProperties":false}}},{"key":"create-automation","title":"Create automation","description":"Create a new automation on a target resource (workspace, database, etc.). Optional purpose selects an AutomationPurposeStrategy that constrains allowedResourceTypes; if the strategy enforces canHaveOnlyOnePerResource and one already exists, the existing automation is returned.","group":"Automation","method":"POST","path":"/resource/:resourceType/:resourceId/automation","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"purpose":{"type":"string","enum":["workspace","automation-app-item","connection-definition","webhook-listener-definition","dynamic-field-values"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"automation":{}},"additionalProperties":false}}},{"key":"get-automations-by-resource","title":"Get automations on resource","description":"List automations attached to a resource. Optional includeContent loads the active version content alongside each automation (heavier — set false unless needed); it must be a boolean (true/false/1/0), anything else is a 400.","group":"Automation","method":"GET","path":"/resource/:resourceType/:resourceId/automations","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automations_on_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":{"type":"object","properties":{"includeContent":{"type":["boolean","string"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"items":{}},"additionalProperties":false}}},{"key":"get-automation","title":"Get automation","description":"Fetch a single automation by id (does not include content — use get-automation-content for that).","group":"Automation","method":"GET","path":"/automation/:automationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automation":{}},"additionalProperties":false}}},{"key":"update-automation","title":"Update automation","description":"Update automation metadata: name, purpose, isOneTimeRunEnabled. Use update-automation-content to change the steps.","group":"Automation","method":"PUT","path":"/automation/:automationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"purpose":{"type":"string","enum":["workspace","automation-app-item","connection-definition","webhook-listener-definition","dynamic-field-values"]},"name":{"type":"string"},"isOneTimeRunEnabled":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"automation":{}},"additionalProperties":false}}},{"key":"toggle-automation","title":"Toggle automation","description":"Enable or disable an automation. Arms or disarms the crons used by its runnable versions, so a disabled automation stops consuming cron ticks. When enabling, returns pendingRunsCount of runs received while the automation was offline.","group":"Automation","method":"PUT","path":"/automation/:automationId/toggle","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Toggle_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"isEnabled":{"type":"boolean"}},"required":["isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{"pendingRunsCount":{"type":["number","null"]}},"required":["pendingRunsCount"],"additionalProperties":false}}},{"key":"delete-automation","title":"Delete automation","description":"Permanently delete an automation and all of its versions, and disable the crons no other runnable version uses. Confirm before calling.","group":"Automation","method":"DELETE","path":"/automation/:automationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-automation-content","title":"Get automation content","description":"Fetch the active version content (the steps) of an automation.","group":"Automation","method":"GET","path":"/automation/:automationId/content","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_content","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":{"type":"object","properties":{"automationRunId":{"type":"string"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"content":{}},"additionalProperties":false}}},{"key":"update-automation-content","title":"Update automation content","description":"Create a new automation version with the provided content. status=Active publishes (and demotes prior Active and Debug versions to Inactive, clearing debug mode); status=Debug enters debug mode (rejected if already debugged). Crons gained by the new version are armed, crons dropped by it are disabled.","group":"Automation","method":"PUT","path":"/automation/:automationId/content","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_automation_content","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"content":{},"status":{"type":"string","enum":["draft","active","debug","inactive"]}},"required":["status"],"additionalProperties":false},"response":{"type":"object","properties":{"automationVersion":{}},"additionalProperties":false}}},{"key":"get-automation-module-port-schemas","title":"Get automation module port schemas","description":"Resolve input/output port configuration for automation canvas modules based on module strategy and options.","group":"Automation","method":"POST","path":"/automation/module-port-schemas","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"modules":{"type":"array","items":{"type":"object","properties":{"moduleKey":{"type":"string"},"uses":{"type":"string"},"partialOptions":{"type":"object","additionalProperties":{}},"existingRelationKeys":{"type":"array","items":{"type":["string","boolean","number","null"]}}},"required":["moduleKey","uses"],"additionalProperties":false}}},"required":["modules"],"additionalProperties":false},"response":{"type":"object","properties":{"portSchemasByModuleKey":{"type":"object","additionalProperties":{"type":"object","properties":{"hasInput":{"type":"boolean"},"outputs":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","boolean","number","null"]},"label":{"type":"string"}},"required":["key"],"additionalProperties":false}}},"required":["hasInput","outputs"],"additionalProperties":false}}},"required":["portSchemasByModuleKey"],"additionalProperties":false}}},{"key":"get-automation-output-schemas","title":"Get automation output schemas","description":"Inspect output schemas inferred from the latest succeeded run step per moduleKey. Useful for wiring downstream steps to upstream output values.","group":"Automation","method":"GET","path":"/automation/:automationId/output-schemas","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_output_schemas","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"outputSchemaItems":{}},"additionalProperties":false}}},{"key":"get-automation-run-steps","title":"Get automation run steps","description":"Fetch the per-step execution log for a single automation run. Useful for diagnosing why a run failed or what each step produced.","group":"Automation","method":"GET","path":"/automation/:automationId/run/:automationRunId/steps","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_run_steps","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"},"automationRunId":{"type":"string"}},"required":["automationId","automationRunId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationRunSteps":{}},"additionalProperties":false}}},{"key":"run-automation","title":"Run automation","description":"Run the automation once by firing one of its manual triggers with an optional input payload. triggerKey selects which manual trigger (defaults to the manual trigger); payload carries the trigger input values. Creates a new automation run.","group":"Automation","method":"POST","path":"/automation/:automationId/run","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Run_automation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"triggerKey":{"type":"string"},"payload":{"type":"object","additionalProperties":{}}},"additionalProperties":false},"response":{"type":"object","properties":{"output":{}},"additionalProperties":false}}},{"key":"get-automation-manual-triggers","title":"Get automation manual triggers","description":"List the manual triggers of an automation with each trigger input schema, for building the run-once form.","group":"Automation","method":"GET","path":"/automation/:automationId/manual-triggers","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_manual_triggers","surface":"search"},"schemas":{"params":{"type":"object","properties":{"automationId":{"type":"string"}},"required":["automationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"manualTriggers":{}},"additionalProperties":false}}},{"key":"create-dashboard-item","title":"Create dashboard item","description":"Add a new widget (dashboard item) to a dashboard. The widget is placed at the first free position on the 4-column grid. Chart and map widgets are pre-configured from a database that can carry them (a map needs a published location field) - the one passed as databaseId when the caller can read it, otherwise the largest readable one in the workspace - and, when no name is given, named after that database and the field they show (e.g. \"Tasks · Status\"). Other types start from the default options of their DashboardItemType.","group":"DashboardItem","method":"POST","path":"/dashboard/:dashboardId/item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_dashboard_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardId":{"type":"string"}},"required":["dashboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"type":{"type":"string","enum":["chart","database-view","time-tracer","map","aggregated-item-list","conversation","activity"]},"databaseId":{"type":"string"}},"required":["type"],"additionalProperties":false},"response":{"type":"object","properties":{"dashboardItem":{}},"additionalProperties":false}}},{"key":"get-dashboard-items","title":"Get dashboard items","description":"List the widgets on a dashboard. Each item is enriched with its merged strategy options.","group":"DashboardItem","method":"GET","path":"/dashboard/:dashboardId/items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_dashboard_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardId":{"type":"string"}},"required":["dashboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"dashboardItems":{"type":"array","items":{}}},"required":["dashboardItems"],"additionalProperties":false}}},{"key":"update-dashboard-item-placement","title":"Update dashboard item placement","description":"Move/resize a widget on the dashboard grid (column, row, width, height).","group":"DashboardItem","method":"PUT","path":"/dashboard-item/:dashboardItemId/placement","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_dashboard_item_placement","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"placement":{}},"additionalProperties":false},"response":{}}},{"key":"update-dashboard-item-name","title":"Update dashboard item name","description":"Rename a widget on a dashboard.","group":"DashboardItem","method":"PUT","path":"/dashboard-item/:dashboardItemId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_dashboard_item_name","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{}}},{"key":"update-dashboard-item-options","title":"Update dashboard item options","description":"Update the type-specific options for a widget. Validated and merged via the DashboardItemType strategy.","group":"DashboardItem","method":"PUT","path":"/dashboard-item/:dashboardItemId/options","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_dashboard_item_options","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"options":{}},"additionalProperties":false},"response":{"type":"object","properties":{"dashboardItem":{}},"additionalProperties":false}}},{"key":"get-dashboard-item-data","title":"Get dashboard item data","description":"Fetch the rendered data for a widget (chart points, list rows, etc.) by delegating to its DashboardItemType strategy.","group":"DashboardItem","method":"POST","path":"/dashboard-item/:dashboardItemId/data","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_dashboard_item_data","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"params":{}},"additionalProperties":false},"response":{"type":"object","properties":{"data":{}},"additionalProperties":false}}},{"key":"delete-dashboard-item","title":"Delete dashboard item","description":"Soft-delete a widget from a dashboard. Confirm before calling - this is destructive.","group":"DashboardItem","method":"DELETE","path":"/dashboard-item/:dashboardItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_dashboard_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"clone-dashboard-item","title":"Clone dashboard item","description":"Duplicate a widget within the same dashboard. The clone is placed at the first free grid position.","group":"DashboardItem","method":"POST","path":"/dashboard-item/:dashboardItemId/clone","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Clone_dashboard_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardItemId":{"type":"string"}},"required":["dashboardItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"dashboardItem":{}},"additionalProperties":false}}},{"key":"create-dashboard","title":"Create dashboard","description":"Create a new dashboard inside a workspace. Optionally place it in a resource group or resource space, and mark it as public (workspace-wide read access) or private (admin-only).","group":"Dashboard","method":"POST","path":"/workspace/:workspaceId/dashboard","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_dashboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"dashboard":{}},"additionalProperties":false}}},{"key":"get-dashboard","title":"Get dashboard","description":"Get a dashboard by its ID.","group":"Dashboard","method":"GET","path":"/dashboard/:dashboardId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_dashboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"dashboardId":{"type":"string"}},"required":["dashboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"dashboard":{}},"additionalProperties":false}}},{"key":"create-automation-app-item-group","title":"Create an automation app item group","description":"Creates a new group inside an automation app, appended to the end of the existing groups by position.","group":"AutomationAppItemGroup","method":"POST","path":"/app/:appId/group","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_an_automation_app_item_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"automationAppItemGroup":{}},"additionalProperties":false}}},{"key":"get-automation-app-item-groups","title":"List groups inside an automation app","description":"Returns the groups that belong to the given automation app, sorted by position.","group":"AutomationAppItemGroup","method":"GET","path":"/app/:appId/groups","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_groups_inside_an_automation_app","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationAppItemGroups":{"type":"array","items":{}}},"required":["automationAppItemGroups"],"additionalProperties":false}}},{"key":"update-automation-app-item-group","title":"Rename an automation app item group","description":"Updates the name of an existing automation app item group.","group":"AutomationAppItemGroup","method":"PUT","path":"/app-group/:appAutomationGroupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_an_automation_app_item_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationGroupId":{"type":"string"}},"required":["appAutomationGroupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-automation-app-item-group-position","title":"Move an automation app item group","description":"Repositions a group within its automation app via `automationService.changeAutomationAppItemGroupPosition`, which renumbers siblings.","group":"AutomationAppItemGroup","method":"PUT","path":"/app-group/:appAutomationGroupId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Move_an_automation_app_item_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationGroupId":{"type":"string"}},"required":["appAutomationGroupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"position":{"type":"number"}},"required":["position"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-automation-app-item-group","title":"Delete an automation app item group","description":"Hard-deletes the group; child automation app items have their `automationAppItemGroupId` cleared so they remain visible at the app root. DESTRUCTIVE.","group":"AutomationAppItemGroup","method":"DELETE","path":"/app-group/:appAutomationGroupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_an_automation_app_item_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationGroupId":{"type":"string"}},"required":["appAutomationGroupId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-my-api-keys","title":"Get my API keys","description":"List API keys belonging to the authenticated user. User-only — non-User entities receive RequestingEntityInvalid (403).","group":"ApiKey","method":"GET","path":"/me/api-keys","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"apiKeys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"secret":{"type":"string"},"isEnabled":{"type":"boolean"}},"required":["id","name","secret","isEnabled"],"additionalProperties":false}}},"required":["apiKeys"],"additionalProperties":false}}},{"key":"create-api-key","title":"Create API key","description":"Generate a new API key for the calling user. Generates a 32-char alphanumeric secret via RandomService. User-only.","group":"ApiKey","method":"POST","path":"/api-key","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"isEnabled":{"type":"boolean"},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["name","isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"secret":{"type":"string"},"isEnabled":{"type":"boolean"}},"required":["id","name","secret","isEnabled"],"additionalProperties":false}},"required":["apiKey"],"additionalProperties":false}}},{"key":"update-api-key","title":"Update API key","description":"Patch name/isEnabled on an API key owned by the caller. Strips undefined fields before update. Refuses keys owned by other users (NOT_ALLOWED).","group":"ApiKey","method":"PATCH","path":"/api-key/:apiKeyId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"apiKeyId":{"type":"string"}},"required":["apiKeyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"isEnabled":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-api-key","title":"Delete API key","description":"Delete an API key owned by the caller. Refuses keys owned by other users.","group":"ApiKey","method":"DELETE","path":"/api-key/:apiKeyId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"apiKeyId":{"type":"string"}},"required":["apiKeyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"list-app-api-keys","title":"List app API keys","description":"List API keys belonging to an automation app. User-only with updateApp — non-User entities receive RequestingEntityInvalid (403).","group":"AppApiKey","method":"GET","path":"/app/:appId/api-keys","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"apiKeys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"secret":{"type":"string"},"isEnabled":{"type":"boolean"}},"required":["id","name","secret","isEnabled"],"additionalProperties":false}}},"required":["apiKeys"],"additionalProperties":false}}},{"key":"create-app-api-key","title":"Create app API key","description":"Generate a new API key for an automation app. Generates a 32-char alphanumeric secret via RandomService. User-only with updateApp.","group":"AppApiKey","method":"POST","path":"/app/:appId/api-keys","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"isEnabled":{"type":"boolean"}},"required":["name","isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"secret":{"type":"string"},"isEnabled":{"type":"boolean"}},"required":["id","name","secret","isEnabled"],"additionalProperties":false}},"required":["apiKey"],"additionalProperties":false}}},{"key":"update-app-api-key","title":"Update app API key","description":"Patch name/isEnabled on an API key belonging to the given app. Strips undefined fields before update. Refuses keys owned by other apps (NOT_ALLOWED).","group":"AppApiKey","method":"PATCH","path":"/app/:appId/api-keys/:apiKeyId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"},"apiKeyId":{"type":"string"}},"required":["appId","apiKeyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"isEnabled":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-app-api-key","title":"Delete app API key","description":"Delete an API key belonging to the given app. Refuses keys owned by other apps.","group":"AppApiKey","method":"DELETE","path":"/app/:appId/api-keys/:apiKeyId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"},"apiKeyId":{"type":"string"}},"required":["appId","apiKeyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-webhook-listeners","title":"List webhook listeners in a workspace","description":"Returns the webhook listeners configured in a workspace. Requires `readWebhookListener`.","group":"WebhookListener","method":"GET","path":"/workspace/:workspaceId/webhook-listeners","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_webhook_listeners_in_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"webhookListeners":{"type":"array","items":{}}},"required":["webhookListeners"],"additionalProperties":false}}},{"key":"create-webhook-listener","title":"Create a webhook listener","description":"Creates a new webhook listener in a workspace, optionally bound to a webhook listener definition with options. Creates the corresponding ResourceItem and emits a WebhookListenerCreated activity. Requires `createWebhookListener`.","group":"WebhookListener","method":"POST","path":"/workspace/:workspaceId/webhook-listener","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_a_webhook_listener","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"options":{"type":"object","additionalProperties":{}},"webhookListenerDefinitionId":{"type":["string","null"]}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"webhookListener":{}},"additionalProperties":false}}},{"key":"update-webhook-listener","title":"Rename a webhook listener","description":"Updates the name of a webhook listener and emits a WebhookListenerUpdated activity. Requires `updateWebhookListener`.","group":"WebhookListener","method":"PUT","path":"/webhook-listener/:webhookListenerId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_a_webhook_listener","surface":"search"},"schemas":{"params":{"type":"object","properties":{"webhookListenerId":{"type":"string"}},"required":["webhookListenerId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{}}},{"key":"delete-webhook-listener","title":"Delete a webhook listener","description":"Hard-deletes a webhook listener; if it was bound to a definition, the definition's `deleteWebhookListener` hook is invoked first to clean up the upstream registration. Emits a WebhookListenerDeleted activity. Requires `deleteWebhookListener`.","group":"WebhookListener","method":"DELETE","path":"/webhook-listener/:webhookListenerId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_a_webhook_listener","surface":"search"},"schemas":{"params":{"type":"object","properties":{"webhookListenerId":{"type":"string"}},"required":["webhookListenerId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"trigger-webhook-listener-by-post","title":"Trigger a webhook listener (POST)","description":"Public-by-id webhook entrypoint: invokes `automationTriggerService.triggerAutomationsByWebhookListener` with the request body. Unauthenticated.","group":"WebhookListener","method":"POST","path":"/webhook-listener/:webhookListenerId/trigger","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"webhookListenerId":{"type":"string"}},"required":["webhookListenerId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"trigger-webhook-listener-by-get","title":"Trigger a webhook listener (GET)","description":"Public-by-id webhook entrypoint over GET: invokes `automationTriggerService.triggerAutomationsByWebhookListener` with the query string. Unauthenticated.","group":"WebhookListener","method":"GET","path":"/webhook-listener/:webhookListenerId/trigger","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"webhookListenerId":{"type":"string"}},"required":["webhookListenerId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-direct-conversation","title":"Create direct conversation","description":"Create a new direct conversation between the authenticated entity and one or more other entities. Returns the existing conversation if a 1:1 chat already exists.","group":"DirectConversation","method":"POST","path":"/direct-conversation","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_direct_conversation","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"entities":{"type":"array","items":{}}},"required":["entities"],"additionalProperties":false},"response":{"type":"object","properties":{"directConversation":{}},"additionalProperties":false}}},{"key":"get-direct-conversation","title":"Get direct conversation","description":"Get a single direct conversation by id.","group":"DirectConversation","method":"GET","path":"/direct-conversation/:directConversationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_direct_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"directConversationId":{"type":"string","minLength":1}},"required":["directConversationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"directConversation":{}},"additionalProperties":false}}},{"key":"get-direct-conversations","title":"Get my direct conversations","description":"List direct conversations the authenticated user has access to.","group":"DirectConversation","method":"GET","path":"/direct-conversations","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_my_direct_conversations","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"directConversations":{"type":"array","items":{}}},"required":["directConversations"],"additionalProperties":false}}},{"key":"update-direct-conversation-name","title":"Rename direct conversation","description":"Rename a direct conversation the authenticated user is a member of.","group":"DirectConversation","method":"PUT","path":"/direct-conversation/:directConversationId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_direct_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"directConversationId":{"type":"string","minLength":1}},"required":["directConversationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"add-members-to-direct-conversation","title":"Add members to direct conversation","description":"Add one or more entities as members to an existing direct conversation the authenticated user is a member of.","group":"DirectConversation","method":"POST","path":"/direct-conversation/:directConversationId/members","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"directConversationId":{"type":"string","minLength":1}},"required":["directConversationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"entities":{"type":"array","items":{"type":"object","properties":{"entityType":{"type":"string","enum":["bot","user","system","guest","app","agent"]},"entityId":{"type":"string","minLength":1}},"required":["entityType","entityId"],"additionalProperties":false},"minItems":1}},"required":["entities"],"additionalProperties":false},"response":{"type":"object","properties":{"directConversation":{}},"additionalProperties":false}}},{"key":"get-job","title":"Get job","description":"Check a background job by its id: status (running | completed | failed), progress, output, and failedReason when it failed. Endpoints that return {jobId} do their work asynchronously — call this to confirm the work actually succeeded and to read the error if it did not. Caller must be the original author of the job, otherwise NotFound is returned (no enumeration leak).","group":"Job","method":"GET","path":"/job/:jobId","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"get_job","surface":"alwaysOn"},"schemas":{"params":{"type":"object","properties":{"jobId":{"type":"string"}},"required":["jobId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"job":{"type":"object","properties":{"jobType":{"type":"string"},"status":{"type":"string","enum":["running","completed","failed"]},"progress":{},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"failedReason":{"type":["string","null"]},"output":{}},"required":["jobType","status","completedAt","failedAt","failedReason"],"additionalProperties":false}},"required":["job"],"additionalProperties":false}}},{"key":"fulfill-verification","title":"Fulfill verification","description":"Fulfill an outstanding verification (e.g. email confirmation, 2FA challenge). Validates the secret/2FA code via the appropriate VerificationType and TwoFactorType strategies, then runs the type-specific fulfilment side effects. No auth required (route is public-by-token).","group":"Verification","method":"POST","path":"/verification/:verificationId/fulfill","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"verificationId":{"type":"string"}},"required":["verificationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"secret":{"type":"string","minLength":1},"fulfillPayload":{}},"required":["secret"],"additionalProperties":false},"response":{"type":"object","properties":{"verification":{}},"additionalProperties":false}}},{"key":"check-verification","title":"Check verification code","description":"Validate the e-mailed code of an outstanding password-reset verification without fulfilling it. On success returns the verification secret used to authorize the actual password change. Wrong codes count against the attempt limit. No auth required (route is public-by-token).","group":"Verification","method":"POST","path":"/verification/:verificationId/check","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"verificationId":{"type":"string"}},"required":["verificationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9]{6}$"}},"required":["code"],"additionalProperties":false},"response":{"type":"object","properties":{"secret":{"type":"string"}},"required":["secret"],"additionalProperties":false}}},{"key":"resend-verification","title":"Resend verification","description":"Re-send the email/code for an outstanding (not yet fulfilled) verification. No auth required (route is public-by-token).","group":"Verification","method":"POST","path":"/verification/:verificationId/resend","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"verificationId":{"type":"string"}},"required":["verificationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-webhooks","title":"Get webhooks for resource","description":"List webhooks scoped to a target resource (resourceType + resourceId). Requires readWebhook permission on the resource.","group":"Webhook","method":"GET","path":"/resource/:resourceType/:resourceId/webhooks","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_webhooks_for_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"webhooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"targetResourceId":{"type":"string"},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"activityItemTypes":{"type":"array","items":{"type":"string","enum":["database.created","database.updated","database.deleted","document.created","document.updated","document.deleted","document.archived","document.restored","whiteboard.created","whiteboard.updated","whiteboard.deleted","whiteboard.archived","whiteboard.restored","workspace.created","workspace.deleted","workspace.updated","database.property.created","database.property.deleted","database.property.updated","database.property.position.updated","database.properties.position.updated","label.created","label.updated","label.deleted","status.created","status.updated","status.deleted","database.item.created","database.item.deleted","database.item.updated.value","database.item.updated.state","database.item.position.updated","database.view.created","database.view.deleted","database.view.updated","database.view.position.updated","database.item.file.created","database.item.file.updated","database.item.file.deleted","resource.item.created","resource.item.deleted","resource.item.renamed","resource.item.icon.updated","resource.item.position.updated","resource.item.payload.updated","resource.group.position.updated","group.member.created","group.member.deleted","message.created","message.deleted","message.updated","connection.created","connection.deleted","connection.updated","conversation.created","conversation.deleted","conversation.updated","dashboard.item.created","dashboard.item.deleted","dashboard.item.updated","cloud.item.created","cloud.item.deleted","cloud.item.updated","database.slice.created","database.slice.deleted","database.slice.updated","database.slice.position.updated","database.time-tracker-item.created","database.time-tracker-item.deleted","database.time-tracker-item.updated","cloud.item.completed-file-variant.created","database.item.file.completed-file-variant.created","message.completed-file-variant.created","dashboard.deleted","call.room.deleted","call.room.updated","folder.deleted","webhook.listener.deleted","webhook.listener.updated","webhook.listener.created","automation.created","automation.deleted","automation.updated","app.updated","app.connection-definition.created","app.connection-definition.deleted","app.webhook-listener-definition.created","app.webhook-listener-definition.deleted","app.dynamic-field-definition.created","app.dynamic-field-definition.deleted","app.item.created","app.item.deleted","app.item.updated","automation.version.created","automation.version.updated","call.participant.created","call.participant.updated","automation.run.created","automation.run.updated","resource.watcher.created","resource.watcher.deleted","workspace.app-access-request.created","workspace.app-access-request.updated","workspace.app-access-request.deleted","agent.created","agent.updated","agent.deleted","agent.archived","agent.restored","agent.run.created","agent.run.updated"]}},"activityItemConditions":{"anyOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"operator":{"type":"string","enum":["equals","notEquals","contains","notContains","in","notIn"]},"value":{}},"required":["field","operator"],"additionalProperties":false}}},{"type":"null"}]},"url":{"type":"string"},"isEnabled":{"type":"boolean"},"name":{"type":"string"},"signingSecret":{"type":"string"},"retryOnFailure":{"type":"boolean"}},"required":["id","targetResourceId","targetResourceType","activityItemTypes","url","isEnabled","name","retryOnFailure"],"additionalProperties":false}}},"required":["webhooks"],"additionalProperties":false}}},{"key":"create-webhook","title":"Create webhook","description":"Create a webhook on a resource. Requires createWebhook permission. Resolves the workspace from the resource path; throws NotFound if missing.","group":"Webhook","method":"POST","path":"/resource/:resourceType/:resourceId/webhook","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_webhook","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"activityItemTypes":{"type":"array","items":{"type":"string","enum":["database.created","database.updated","database.deleted","document.created","document.updated","document.deleted","document.archived","document.restored","whiteboard.created","whiteboard.updated","whiteboard.deleted","whiteboard.archived","whiteboard.restored","workspace.created","workspace.deleted","workspace.updated","database.property.created","database.property.deleted","database.property.updated","database.property.position.updated","database.properties.position.updated","label.created","label.updated","label.deleted","status.created","status.updated","status.deleted","database.item.created","database.item.deleted","database.item.updated.value","database.item.updated.state","database.item.position.updated","database.view.created","database.view.deleted","database.view.updated","database.view.position.updated","database.item.file.created","database.item.file.updated","database.item.file.deleted","resource.item.created","resource.item.deleted","resource.item.renamed","resource.item.icon.updated","resource.item.position.updated","resource.item.payload.updated","resource.group.position.updated","group.member.created","group.member.deleted","message.created","message.deleted","message.updated","connection.created","connection.deleted","connection.updated","conversation.created","conversation.deleted","conversation.updated","dashboard.item.created","dashboard.item.deleted","dashboard.item.updated","cloud.item.created","cloud.item.deleted","cloud.item.updated","database.slice.created","database.slice.deleted","database.slice.updated","database.slice.position.updated","database.time-tracker-item.created","database.time-tracker-item.deleted","database.time-tracker-item.updated","cloud.item.completed-file-variant.created","database.item.file.completed-file-variant.created","message.completed-file-variant.created","dashboard.deleted","call.room.deleted","call.room.updated","folder.deleted","webhook.listener.deleted","webhook.listener.updated","webhook.listener.created","automation.created","automation.deleted","automation.updated","app.updated","app.connection-definition.created","app.connection-definition.deleted","app.webhook-listener-definition.created","app.webhook-listener-definition.deleted","app.dynamic-field-definition.created","app.dynamic-field-definition.deleted","app.item.created","app.item.deleted","app.item.updated","automation.version.created","automation.version.updated","call.participant.created","call.participant.updated","automation.run.created","automation.run.updated","resource.watcher.created","resource.watcher.deleted","workspace.app-access-request.created","workspace.app-access-request.updated","workspace.app-access-request.deleted","agent.created","agent.updated","agent.deleted","agent.archived","agent.restored","agent.run.created","agent.run.updated"]}},"activityItemConditions":{"anyOf":[{"anyOf":[{"not":{}},{}]},{"type":"null"}]},"isEnabled":{"type":"boolean"},"retryOnFailure":{"type":"boolean"}},"required":["name","url","activityItemTypes","isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"type":"string"},"targetResourceId":{"type":"string"},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"activityItemTypes":{"type":"array","items":{"type":"string","enum":["database.created","database.updated","database.deleted","document.created","document.updated","document.deleted","document.archived","document.restored","whiteboard.created","whiteboard.updated","whiteboard.deleted","whiteboard.archived","whiteboard.restored","workspace.created","workspace.deleted","workspace.updated","database.property.created","database.property.deleted","database.property.updated","database.property.position.updated","database.properties.position.updated","label.created","label.updated","label.deleted","status.created","status.updated","status.deleted","database.item.created","database.item.deleted","database.item.updated.value","database.item.updated.state","database.item.position.updated","database.view.created","database.view.deleted","database.view.updated","database.view.position.updated","database.item.file.created","database.item.file.updated","database.item.file.deleted","resource.item.created","resource.item.deleted","resource.item.renamed","resource.item.icon.updated","resource.item.position.updated","resource.item.payload.updated","resource.group.position.updated","group.member.created","group.member.deleted","message.created","message.deleted","message.updated","connection.created","connection.deleted","connection.updated","conversation.created","conversation.deleted","conversation.updated","dashboard.item.created","dashboard.item.deleted","dashboard.item.updated","cloud.item.created","cloud.item.deleted","cloud.item.updated","database.slice.created","database.slice.deleted","database.slice.updated","database.slice.position.updated","database.time-tracker-item.created","database.time-tracker-item.deleted","database.time-tracker-item.updated","cloud.item.completed-file-variant.created","database.item.file.completed-file-variant.created","message.completed-file-variant.created","dashboard.deleted","call.room.deleted","call.room.updated","folder.deleted","webhook.listener.deleted","webhook.listener.updated","webhook.listener.created","automation.created","automation.deleted","automation.updated","app.updated","app.connection-definition.created","app.connection-definition.deleted","app.webhook-listener-definition.created","app.webhook-listener-definition.deleted","app.dynamic-field-definition.created","app.dynamic-field-definition.deleted","app.item.created","app.item.deleted","app.item.updated","automation.version.created","automation.version.updated","call.participant.created","call.participant.updated","automation.run.created","automation.run.updated","resource.watcher.created","resource.watcher.deleted","workspace.app-access-request.created","workspace.app-access-request.updated","workspace.app-access-request.deleted","agent.created","agent.updated","agent.deleted","agent.archived","agent.restored","agent.run.created","agent.run.updated"]}},"activityItemConditions":{"anyOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"operator":{"type":"string","enum":["equals","notEquals","contains","notContains","in","notIn"]},"value":{}},"required":["field","operator"],"additionalProperties":false}}},{"type":"null"}]},"url":{"type":"string"},"isEnabled":{"type":"boolean"},"name":{"type":"string"},"signingSecret":{"type":"string"},"retryOnFailure":{"type":"boolean"}},"required":["id","targetResourceId","targetResourceType","activityItemTypes","url","isEnabled","name","retryOnFailure"],"additionalProperties":false}},"required":["webhook"],"additionalProperties":false}}},{"key":"update-webhook","title":"Update webhook","description":"Patch name/url/activityItemTypes/activityItemConditions/isEnabled on a webhook. Requires createWebhook permission on the parent resource (matches legacy gate).","group":"Webhook","method":"PUT","path":"/resource/:resourceType/:resourceId/webhook/:webhookId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_webhook","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"webhookId":{"type":"string"}},"required":["resourceType","resourceId","webhookId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"},"activityItemTypes":{"type":"array","items":{"type":"string","enum":["database.created","database.updated","database.deleted","document.created","document.updated","document.deleted","document.archived","document.restored","whiteboard.created","whiteboard.updated","whiteboard.deleted","whiteboard.archived","whiteboard.restored","workspace.created","workspace.deleted","workspace.updated","database.property.created","database.property.deleted","database.property.updated","database.property.position.updated","database.properties.position.updated","label.created","label.updated","label.deleted","status.created","status.updated","status.deleted","database.item.created","database.item.deleted","database.item.updated.value","database.item.updated.state","database.item.position.updated","database.view.created","database.view.deleted","database.view.updated","database.view.position.updated","database.item.file.created","database.item.file.updated","database.item.file.deleted","resource.item.created","resource.item.deleted","resource.item.renamed","resource.item.icon.updated","resource.item.position.updated","resource.item.payload.updated","resource.group.position.updated","group.member.created","group.member.deleted","message.created","message.deleted","message.updated","connection.created","connection.deleted","connection.updated","conversation.created","conversation.deleted","conversation.updated","dashboard.item.created","dashboard.item.deleted","dashboard.item.updated","cloud.item.created","cloud.item.deleted","cloud.item.updated","database.slice.created","database.slice.deleted","database.slice.updated","database.slice.position.updated","database.time-tracker-item.created","database.time-tracker-item.deleted","database.time-tracker-item.updated","cloud.item.completed-file-variant.created","database.item.file.completed-file-variant.created","message.completed-file-variant.created","dashboard.deleted","call.room.deleted","call.room.updated","folder.deleted","webhook.listener.deleted","webhook.listener.updated","webhook.listener.created","automation.created","automation.deleted","automation.updated","app.updated","app.connection-definition.created","app.connection-definition.deleted","app.webhook-listener-definition.created","app.webhook-listener-definition.deleted","app.dynamic-field-definition.created","app.dynamic-field-definition.deleted","app.item.created","app.item.deleted","app.item.updated","automation.version.created","automation.version.updated","call.participant.created","call.participant.updated","automation.run.created","automation.run.updated","resource.watcher.created","resource.watcher.deleted","workspace.app-access-request.created","workspace.app-access-request.updated","workspace.app-access-request.deleted","agent.created","agent.updated","agent.deleted","agent.archived","agent.restored","agent.run.created","agent.run.updated"]}},"activityItemConditions":{"anyOf":[{"anyOf":[{"not":{}},{}]},{"type":"null"}]},"isEnabled":{"type":"boolean"},"retryOnFailure":{"type":"boolean"}},"required":["name","url","activityItemTypes","isEnabled"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-webhook","title":"Delete webhook","description":"Delete a webhook by id. Reads the webhook first, resolves its resource path, and enforces deleteWebhook permission. Throws NotFound if the webhook does not exist.","group":"Webhook","method":"DELETE","path":"/webhook/:webhookId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_webhook","surface":"search"},"schemas":{"params":{"type":"object","properties":{"webhookId":{"type":"string"}},"required":["webhookId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"rotate-webhook-signing-secret","title":"Rotate webhook signing secret","description":"Replace the HMAC signing secret for a webhook. Reads the webhook by id, resolves its resource path, and requires createWebhook permission. Previous signatures stop verifying immediately.","group":"Webhook","method":"POST","path":"/webhook/:webhookId/signing-secret/rotate","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"webhookId":{"type":"string"}},"required":["webhookId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"type":"string"},"targetResourceId":{"type":"string"},"targetResourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"activityItemTypes":{"type":"array","items":{"type":"string","enum":["database.created","database.updated","database.deleted","document.created","document.updated","document.deleted","document.archived","document.restored","whiteboard.created","whiteboard.updated","whiteboard.deleted","whiteboard.archived","whiteboard.restored","workspace.created","workspace.deleted","workspace.updated","database.property.created","database.property.deleted","database.property.updated","database.property.position.updated","database.properties.position.updated","label.created","label.updated","label.deleted","status.created","status.updated","status.deleted","database.item.created","database.item.deleted","database.item.updated.value","database.item.updated.state","database.item.position.updated","database.view.created","database.view.deleted","database.view.updated","database.view.position.updated","database.item.file.created","database.item.file.updated","database.item.file.deleted","resource.item.created","resource.item.deleted","resource.item.renamed","resource.item.icon.updated","resource.item.position.updated","resource.item.payload.updated","resource.group.position.updated","group.member.created","group.member.deleted","message.created","message.deleted","message.updated","connection.created","connection.deleted","connection.updated","conversation.created","conversation.deleted","conversation.updated","dashboard.item.created","dashboard.item.deleted","dashboard.item.updated","cloud.item.created","cloud.item.deleted","cloud.item.updated","database.slice.created","database.slice.deleted","database.slice.updated","database.slice.position.updated","database.time-tracker-item.created","database.time-tracker-item.deleted","database.time-tracker-item.updated","cloud.item.completed-file-variant.created","database.item.file.completed-file-variant.created","message.completed-file-variant.created","dashboard.deleted","call.room.deleted","call.room.updated","folder.deleted","webhook.listener.deleted","webhook.listener.updated","webhook.listener.created","automation.created","automation.deleted","automation.updated","app.updated","app.connection-definition.created","app.connection-definition.deleted","app.webhook-listener-definition.created","app.webhook-listener-definition.deleted","app.dynamic-field-definition.created","app.dynamic-field-definition.deleted","app.item.created","app.item.deleted","app.item.updated","automation.version.created","automation.version.updated","call.participant.created","call.participant.updated","automation.run.created","automation.run.updated","resource.watcher.created","resource.watcher.deleted","workspace.app-access-request.created","workspace.app-access-request.updated","workspace.app-access-request.deleted","agent.created","agent.updated","agent.deleted","agent.archived","agent.restored","agent.run.created","agent.run.updated"]}},"activityItemConditions":{"anyOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"operator":{"type":"string","enum":["equals","notEquals","contains","notContains","in","notIn"]},"value":{}},"required":["field","operator"],"additionalProperties":false}}},{"type":"null"}]},"url":{"type":"string"},"isEnabled":{"type":"boolean"},"name":{"type":"string"},"signingSecret":{"type":"string"},"retryOnFailure":{"type":"boolean"}},"required":["id","targetResourceId","targetResourceType","activityItemTypes","url","isEnabled","name","retryOnFailure"],"additionalProperties":false}},"required":["webhook"],"additionalProperties":false}}},{"key":"setup-two-factor","title":"Setup two-factor","description":"Begin two-factor enrolment for the authenticated user. Returns strategy-specific setupOutput and a verificationId used by the enable step.","group":"TwoFactor","method":"POST","path":"/two-factor/setup","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"twoFactorType":{"type":"string","enum":["sms","mail","totp"]}},"required":["twoFactorType"],"additionalProperties":false},"response":{"type":"object","properties":{"setupOutput":{},"verificationId":{"type":"string"}},"required":["verificationId"],"additionalProperties":false}}},{"key":"enable-two-factor","title":"Enable two-factor","description":"Confirm a two-factor enrolment by verifying the supplied code.","group":"TwoFactor","method":"POST","path":"/two-factor/enable","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"code":{"type":"string"},"twoFactorType":{"type":"string","enum":["sms","mail","totp"]},"verificationId":{"type":"string"}},"required":["code","twoFactorType","verificationId"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"disable-two-factor","title":"Disable two-factor","description":"Disable two-factor for the authenticated user. Idempotent.","group":"TwoFactor","method":"DELETE","path":"/two-factor","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-automation-app","title":"Create an automation app in a workspace","description":"Creates a new automation app in `Draft` state, attaches default permissions for the requesting entity, and creates the corresponding ResourceItem so it appears in the workspace sidebar.","group":"AutomationApp","method":"POST","path":"/workspace/:workspaceId/app","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_an_automation_app_in_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"collectionItemParentId":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"automationApp":{}},"additionalProperties":false}}},{"key":"get-automation-apps","title":"Search the global automation app catalog","description":"Returns automation apps across all workspaces, filtered by case-insensitive name regex via `?search=`. Includes built-in apps and any published custom apps the requester is allowed to see.","group":"AutomationApp","method":"GET","path":"/apps","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Search_the_global_automation_app_catalog","surface":"search"},"schemas":{"params":null,"query":{"type":"object","properties":{"search":{"type":["string","null"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"automationApps":{"type":"array","items":{}}},"required":["automationApps"],"additionalProperties":false}}},{"key":"get-automation-apps-by-category","title":"List automation apps in a category","description":"Returns the automation apps that belong to a given app category (matched against `appCategoryIds` array contains).","group":"AutomationApp","method":"GET","path":"/app-category/:appCategoryId/apps","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_automation_apps_in_a_category","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appCategoryId":{"type":"string"}},"required":["appCategoryId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationApps":{"type":"array","items":{}}},"required":["automationApps"],"additionalProperties":false}}},{"key":"get-automation-app","title":"Get a single automation app","description":"Returns one automation app by id. Requires `readApp` permission.","group":"AutomationApp","method":"GET","path":"/app/:appId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_a_single_automation_app","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationApp":{}},"additionalProperties":false}}},{"key":"update-automation-app","title":"Update an automation app","description":"Updates `key`, `name`, `description`, `appCategoryIds`, `iconColor`, and/or `state` on an automation app. Undefined keys are stripped before persistence so a partial body never blanks unrelated fields. Requires `updateApp`.","group":"AutomationApp","method":"PATCH","path":"/app/:appId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_an_automation_app","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"appCategoryIds":{"type":"array","items":{"type":"string"}},"iconColor":{"type":["string","null"]},"state":{"type":"string","enum":["draft","pending-review","verified","published","rejected"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-automation-apps-by-workspace","title":"List automation apps owned by a workspace","description":"Returns the automation apps registered in the given workspace. Requires `readApp` on the workspace.","group":"AutomationApp","method":"GET","path":"/workspace/:workspaceId/apps","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_automation_apps_owned_by_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationApps":{"type":"array","items":{}}},"required":["automationApps"],"additionalProperties":false}}},{"key":"get-automation-app-input-schema","title":"Get the input schema for an automation module","description":"Resolves the input schema for the module identified by `${appKey}/${appAutomationKey}` (trigger or action). `partialOptions` lets the strategy compute dynamic fields whose shape depends on already-selected options.","group":"AutomationApp","method":"POST","path":"/app/:appKey/:appAutomationKey/input-schema","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_the_input_schema_for_an_automation_module","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appKey":{"type":"string"},"appAutomationKey":{"type":"string"}},"required":["appKey","appAutomationKey"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partialOptions":{"type":"object","additionalProperties":{}}},"required":["partialOptions"],"additionalProperties":false},"response":{"type":"object","properties":{"automationModuleInputSchema":{},"automationModulePortSchema":{"type":"object","properties":{"hasInput":{"type":"boolean"},"outputs":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","boolean","number","null"]},"label":{"type":"string"}},"required":["key"],"additionalProperties":false}}},"required":["hasInput","outputs"],"additionalProperties":false}},"required":["automationModulePortSchema"],"additionalProperties":false}}},{"key":"get-automation-app-output-schema","title":"Get the output schema for an automation module","description":"Resolves the output schema for the module identified by the app + item key. `partialOptions` lets the strategy compute dynamic fields whose shape depends on already-selected options.","group":"AutomationApp","method":"POST","path":"/app/:appKey/:appAutomationKey/output-schema","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_the_output_schema_for_an_automation_module","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appKey":{"type":"string"},"appAutomationKey":{"type":"string"}},"required":["appKey","appAutomationKey"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partialOptions":{"type":"object","additionalProperties":{}}},"required":["partialOptions"],"additionalProperties":false},"response":{"type":"object","properties":{"automationModuleInputSchema":{},"automationModulePortSchema":{"type":"object","properties":{"hasInput":{"type":"boolean"},"outputs":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","boolean","number","null"]},"label":{"type":"string"}},"required":["key"],"additionalProperties":false}}},"required":["hasInput","outputs"],"additionalProperties":false}},"required":["automationModulePortSchema"],"additionalProperties":false}}},{"key":"get-automation-apps-by-keys","title":"Bulk-fetch automation apps by key","description":"Returns automation apps matching any of the supplied `keys`.","group":"AutomationApp","method":"POST","path":"/apps/by-keys","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Bulk-fetch_automation_apps_by_key","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string"}}},"required":["keys"],"additionalProperties":false},"response":{"type":"object","properties":{"automationApps":{"type":"array","items":{}}},"required":["automationApps"],"additionalProperties":false}}},{"key":"delete-automation-app","title":"Delete an automation app","description":"Hard-deletes an automation app and emits a `ResourceItemDeleted` activity. DESTRUCTIVE.","group":"AutomationApp","method":"DELETE","path":"/app/:appId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_an_automation_app","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-app-manifest","title":"Export a whole app as one manifest","description":"Returns the entire app (meta + connection definitions + items) with each automation content, as a single manifest.","group":"AutomationApp","method":"GET","path":"/app/:appId/manifest","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Export_a_whole_app_as_one_manifest","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"manifest":{}},"additionalProperties":false}}},{"key":"import-app-manifest","title":"Import a manifest to update a whole app","description":"Applies a manifest to an app: updates the app meta, creates missing connection definitions and items, updates the content of existing ones and, in replace mode, deletes the ones absent from the manifest. Pass isDryRun to get the plan without writing anything.","group":"AutomationApp","method":"POST","path":"/app/:appId/manifest","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Import_a_manifest_to_update_a_whole_app","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"manifest":{"type":"object","properties":{"app":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"version":{"type":"number"}},"required":["key","name"],"additionalProperties":false},"connectionDefinitions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"content":{"type":"object","properties":{"modules":{"type":"array"},"relations":{"type":"array"}},"required":["modules","relations"],"additionalProperties":false}},"required":["name","content"],"additionalProperties":false}},"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"group":{"type":["string","null"]},"content":{"$ref":"#/properties/manifest/properties/connectionDefinitions/items/properties/content"}},"required":["key","name","content"],"additionalProperties":false}}},"required":["app","connectionDefinitions","items"],"additionalProperties":false},"mode":{"type":"string","enum":["merge","replace"]},"isDryRun":{"type":"boolean"}},"required":["manifest"],"additionalProperties":false},"response":{"type":"object","properties":{"result":{"type":"object","properties":{"mode":{"type":"string","enum":["merge","replace"]},"isDryRun":{"type":"boolean"},"app":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"actionType":{"type":"string","enum":["created","updated","deleted","unchanged"]}},"required":["key","name","actionType"],"additionalProperties":false},"connectionDefinitions":{"type":"array","items":{"$ref":"#/properties/result/properties/app"}},"items":{"type":"array","items":{"$ref":"#/properties/result/properties/app"}}},"required":["mode","isDryRun","app","connectionDefinitions","items"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}},{"key":"get-database-item-files","title":"List files attached to an item on a property","description":"Returns the files attached to a given database item under a `Files` property, sorted by `?sort=` and `?sortDirection=` (defaults to created-desc). User/Guest only.","group":"DatabaseItemFile","method":"GET","path":"/item/:databaseItemId/property/:propertyId/files","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_files_attached_to_an_item_on_a_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseItemId","propertyId"],"additionalProperties":false},"query":{"type":"object","properties":{"sort":{"type":"string","enum":["name","createdAt","size","type"]},"sortDirection":{"type":"string","enum":["asc","desc"]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"databaseItemFiles":{"type":"array","items":{}}},"required":["databaseItemFiles"],"additionalProperties":false}}},{"key":"get-database-item-files-by-properties-ids","title":"Bulk-list files for an item across multiple properties","description":"Returns the files attached to a database item across the supplied `propertyIds`, filtered to properties the requester can read.","group":"DatabaseItemFile","method":"POST","path":"/item/:databaseItemId/files","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Bulk-list_files_for_an_item_across_multiple_prop","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"propertyIds":{"type":"array","items":{"type":"string"}},"sort":{"type":"string","enum":["name","createdAt","size","type"]},"sortDirection":{"type":"string","enum":["asc","desc"]}},"required":["propertyIds"],"additionalProperties":false},"response":{"type":"object","properties":{"databaseItemFiles":{"type":"array","items":{}}},"required":["databaseItemFiles"],"additionalProperties":false}}},{"key":"get-database-item-file","title":"Get a single database item file","description":"Returns one database item file by id (with author and underlying file populated). Requires `readDatabaseProperty`. User/Guest only.","group":"DatabaseItemFile","method":"GET","path":"/database-item-file/:databaseItemFileId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_a_single_database_item_file","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemFileId":{"type":"string"}},"required":["databaseItemFileId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databaseItemFile":{}},"additionalProperties":false}}},{"key":"get-database-item-file-neighbors","title":"Get previous/next files for a file (for slideshow nav)","description":"Returns the previous and next file under the same item+property, sorted by createdAt ascending — useful to wire prev/next buttons in a viewer.","group":"DatabaseItemFile","method":"GET","path":"/database-item-file/:databaseItemFileId/neighbors","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_previous_next_files_for_a_file_for_slideshow","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemFileId":{"type":"string"}},"required":["databaseItemFileId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"previousDatabaseItemFile":{"anyOf":[{},{"type":"null"}]},"nextDatabaseItemFile":{"anyOf":[{},{"type":"null"}]}},"additionalProperties":false}}},{"key":"delete-database-item-file","title":"Soft-delete a database item file","description":"Soft-deletes the file (sets `deletedAt`), removes the underlying File record, triggers value updates on dependants, and emits a `DatabaseCellFileDeleted` event.","group":"DatabaseItemFile","method":"DELETE","path":"/database-item-file/:databaseItemFileId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Soft-delete_a_database_item_file","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemFileId":{"type":"string"}},"required":["databaseItemFileId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"download-database-item-file","title":"Get a download link for a database item file","description":"Returns a signed download URL (`{downloadLink: string}`) pointing at the object storage host; the adapter does NOT stream the binary itself. Only useful when you can make an outbound HTTP request to that host and want to hand the link to a human. If you need to READ the file contents yourself, do not use this - use `Get a database item file as a base64 data URI` instead, which returns the bytes through this API and needs no extra network access.","group":"DatabaseItemFile","method":"GET","path":"/database-item-file/:databaseItemFileId/download","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseItemFileId":{"type":"string"}},"required":["databaseItemFileId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"downloadLink":{"type":"string"}},"required":["downloadLink"],"additionalProperties":false}}},{"key":"get-database-item-file-data-uri","title":"Read the contents of a database item file","description":"Read the actual contents of a file attached to a database item. Returns the bytes inline through this API, so it needs no network access to the object storage host. Use this whenever you need to read, summarise, translate or extract data from an attachment. Accepts files up to 15 MB. Images are returned as a native image block; other types come back as a base64 data URI in `{dataUri}`. This is the only way to obtain file contents over MCP.","group":"DatabaseItemFile","method":"GET","path":"/database-item/:databaseItemId/property/:propertyId/data-uri","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseItemId","propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"dataUri":{"type":"string"}},"required":["dataUri"],"additionalProperties":false}}},{"key":"download-all-database-item-files-by-property","title":"Get download links for all files of an item under one property","description":"Returns `{downloadFiles: [{title, url}]}` for every file on the given item under a single readable property. These are storage links, not contents - to read the files, list them and then call `Get a database item file as a base64 data URI` per file.","group":"DatabaseItemFile","method":"GET","path":"/item/:databaseItemId/property/:propertyId/download-all-files","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseItemId","propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"downloadFiles":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"],"additionalProperties":false}}},"required":["downloadFiles"],"additionalProperties":false}}},{"key":"download-all-database-item-files-by-item","title":"Get download links for all files of an item across all readable properties","description":"Same as `DownloadAllDatabaseItemFilesByProperty` but across every readable `Files` property on the item. Returns storage links, not contents - to read the files, call `Get a database item file as a base64 data URI` per file.","group":"DatabaseItemFile","method":"GET","path":"/item/:databaseItemId/download-all-files","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"}},"required":["databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"downloadFiles":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"],"additionalProperties":false}}},"required":["downloadFiles"],"additionalProperties":false}}},{"key":"rename-database-item-file","title":"Rename a database item file","description":"Updates the `title` of a database item file. Emits a `DatabaseCellFileUpdated` activity carrying previous/current snapshots.","group":"DatabaseItemFile","method":"PUT","path":"/database-item-file/:databaseItemFileId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_a_database_item_file","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemFileId":{"type":"string"}},"required":["databaseItemFileId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-conversation","title":"Create conversation","description":"Create a new workspace-scoped conversation. Optionally place it in a resource group/space and mark public/private.","group":"Conversation","method":"POST","path":"/workspace/:workspaceId/conversation","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"isPublic":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"conversation":{}},"additionalProperties":false}}},{"key":"get-conversation","title":"Get conversation","description":"Get a conversation by its ID.","group":"Conversation","method":"GET","path":"/conversation/:conversationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationId":{"type":"string"}},"required":["conversationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"conversation":{}},"additionalProperties":false}}},{"key":"get-workspace-conversations","title":"Get workspace conversations","description":"List the workspace-scoped conversations (channels) the authenticated user has access to, sorted by most recent activity.","group":"Conversation","method":"GET","path":"/workspace/:workspaceId/conversations","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_workspace_conversations","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"conversations":{"type":"array","items":{}}},"required":["conversations"],"additionalProperties":false}}},{"key":"get-thread-conversations-unread-count","title":"Get unread thread count","description":"Count the contextual thread conversations the authenticated user has unread messages in. Powers the Threads tab badge on its own, without listing a page of threads.","group":"Conversation","method":"GET","path":"/workspace/:workspaceId/thread-conversations/unread-count","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_unread_thread_count","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"unreadThreadCount":{"type":"number"}},"required":["unreadThreadCount"],"additionalProperties":false}}},{"key":"get-thread-conversations","title":"Get thread conversations","description":"List the contextual thread conversations (database cell/file and cloud file comments) the authenticated user participates in, sorted by most recent activity.","group":"Conversation","method":"GET","path":"/workspace/:workspaceId/thread-conversations","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_thread_conversations","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"threadConversations":{"type":"array","items":{}},"nextCursor":{"type":["string","null"]}},"required":["threadConversations","nextCursor"],"additionalProperties":false}}},{"key":"set-thread-conversation-state","title":"Mute or leave a thread conversation","description":"Sets the participation state of the requesting user on one contextual thread: `isMuted` silences it, `isFollowed: false` removes it from their chats hub until they take part again.","group":"Conversation","method":"POST","path":"/workspace/:workspaceId/thread-conversations/state","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mute_or_leave_a_thread_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]},"conversationKey":{"type":"string"},"isMuted":{"type":"boolean"},"isFollowed":{"type":"boolean"}},"required":["conversationType","conversationKey"],"additionalProperties":false},"response":{"type":"object","properties":{"isMuted":{"type":"boolean"},"isFollowed":{"type":"boolean"}},"required":["isMuted","isFollowed"],"additionalProperties":false}}},{"key":"delete-conversation","title":"Delete conversation","description":"Soft-delete a conversation. Confirm before calling - this is destructive.","group":"Conversation","method":"DELETE","path":"/conversation/:conversationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_conversation","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationId":{"type":"string"}},"required":["conversationId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"conversation":{"type":"null"}},"required":["conversation"],"additionalProperties":false}}},{"key":"create-checklist","title":"Create checklist","description":"Create a new checklist on a database property (column). The checklist title is required. Returns the created checklist.","group":"Checklist","method":"POST","path":"/checklist/property/:propertyId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_checklist","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"checklist":{}},"additionalProperties":false}}},{"key":"duplicate-checklist","title":"Duplicate checklist","description":"Duplicate an existing checklist (including its items) and save the copy as a template. The new title is the source title with \" copy\" appended.","group":"Checklist","method":"POST","path":"/checklist/:checklistId/duplicate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Duplicate_checklist","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistId":{"type":"string"}},"required":["checklistId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-checklists","title":"Get checklists","description":"Fetch checklists by ids together with their items. Returns the list (no permission check by design — checklists are scoped to their parent property).","group":"Checklist","method":"POST","path":"/checklists","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_checklists","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"checklistIds":{"type":"array","items":{"type":"string"}}},"required":["checklistIds"],"additionalProperties":false},"response":{"type":"object","properties":{"checklists":{}},"additionalProperties":false}}},{"key":"get-saved-checklist","title":"Get saved checklist templates","description":"List user-saved checklist templates for a database property (excluding built-in templates).","group":"Checklist","method":"GET","path":"/checklist-saved/:propertyId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_saved_checklist_templates","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"checklists":{}},"additionalProperties":false}}},{"key":"get-build-in-checklists","title":"Get built-in checklist templates","description":"List built-in checklist templates available to all workspaces.","group":"Checklist","method":"GET","path":"/checklist-templates","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_built-in_checklist_templates","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"checklists":{}},"additionalProperties":false}}},{"key":"save-checklist","title":"Save checklist as template","description":"Mark an existing checklist as a saved template so it can be re-used on the same property.","group":"Checklist","method":"POST","path":"/checklist/:checklistId/save","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Save_checklist_as_template","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistId":{"type":"string"}},"required":["checklistId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"checklist":{}},"additionalProperties":false}}},{"key":"update-checklist","title":"Update checklist","description":"Rename a checklist by id.","group":"Checklist","method":"PUT","path":"/checklist/:checklistId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_checklist","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistId":{"type":"string"}},"required":["checklistId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"checklist":{}},"additionalProperties":false}}},{"key":"delete-checklist","title":"Delete checklist","description":"Permanently delete a checklist. Confirm before calling — this also drops the items beneath it.","group":"Checklist","method":"DELETE","path":"/checklist/:checklistId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_checklist","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistId":{"type":"string"}},"required":["checklistId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-checklist-item","title":"Create checklist item","description":"Append a new item to a checklist. The checklist must already exist.","group":"Checklist","method":"POST","path":"/checklist/:checklistId/item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_checklist_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistId":{"type":"string"}},"required":["checklistId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"checklistItem":{}},"additionalProperties":false}}},{"key":"update-checklist-item","title":"Update checklist item","description":"Rename a checklist item by id.","group":"Checklist","method":"PUT","path":"/checklistItem/:checklistItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_checklist_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistItemId":{"type":"string"}},"required":["checklistItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"checklistItem":{}},"additionalProperties":false}}},{"key":"delete-checklist-item","title":"Delete checklist item","description":"Permanently delete a single checklist item. Confirm before calling.","group":"Checklist","method":"DELETE","path":"/checklistItem/:checklistItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_checklist_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"checklistItemId":{"type":"string"}},"required":["checklistItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-resource-groups","title":"Get resource groups","description":"List resource groups in a workspace, sorted by position. Permission-filtered by readResourceGroup; positions are renormalized to a contiguous 0..N-1 range over the visible groups.","group":"ResourceGroup","method":"GET","path":"/workspace/:workspaceId/resource-groups","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_resource_groups","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"resourceGroups":{}},"additionalProperties":false}}},{"key":"create-resource-group","title":"Create resource group","description":"Create a resource group in a workspace at the next free position. Optional resourceSpaceId associates the group with a space.","group":"ResourceGroup","method":"POST","path":"/workspace/:workspaceId/resource-group","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_resource_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"resourceSpaceId":{"type":["string","null"]}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"resourceGroup":{}},"additionalProperties":false}}},{"key":"update-resource-group-position","title":"Update resource group position","description":"Reorder a resource group by an offset (relative move). Optionally moves the group to a different resource space.","group":"ResourceGroup","method":"PUT","path":"/resource-group/:resourceGroupId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_resource_group_position","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceGroupId":{"type":"string"}},"required":["resourceGroupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"offset":{"type":"number"},"resourceSpaceId":{"type":["string","null"]}},"required":["offset"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-resource-group-name","title":"Update resource group name","description":"Rename a resource group by id.","group":"ResourceGroup","method":"PUT","path":"/resource-group/:resourceGroupId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_resource_group_name","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceGroupId":{"type":"string"}},"required":["resourceGroupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"resourceGroup":{}},"additionalProperties":false}}},{"key":"delete-resource-group","title":"Delete resource group","description":"Soft-delete a resource group. The contained resource items are detached (resourceGroupId set to null). Confirm before calling.","group":"ResourceGroup","method":"DELETE","path":"/resource-group/:resourceGroupId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_resource_group","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceGroupId":{"type":"string"}},"required":["resourceGroupId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"withContent":{"type":"boolean"}},"required":["withContent"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-connection-definition","title":"Create connection definition","description":"Register a new connection definition (the workspace-installable spec) under an automation app.","group":"ConnectionDefinition","method":"POST","path":"/app/:appId/connection-definition","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_connection_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"connectionDefinition":{}},"additionalProperties":false}}},{"key":"delete-connection-definition","title":"Delete connection definition","description":"Soft-delete a connection definition. Connections already created from it keep working; the definition just stops being offered. Requires deleteConnectionDefinition.","group":"ConnectionDefinition","method":"DELETE","path":"/connection-definition/:connectionDefinitionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_connection_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"connectionDefinitionId":{"type":"string"}},"required":["connectionDefinitionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-connection-definitions","title":"Get connection definitions","description":"List the connection definitions registered under an automation app.","group":"ConnectionDefinition","method":"GET","path":"/app/:appId/connection-definitions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_connection_definitions","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"connectionDefinitions":{}},"additionalProperties":false}}},{"key":"get-connection-definitions-by-workspace","title":"Get connection definitions by workspace","description":"List every connection definition registered under the automation apps of a workspace, together with the apps that own them. Answers in one request what would otherwise be one request per app.","group":"ConnectionDefinition","method":"GET","path":"/workspace/:workspaceId/connection-definitions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_connection_definitions_by_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"connectionDefinitions":{},"automationApps":{}},"additionalProperties":false}}},{"key":"get-connection-definition-input-schema","title":"Get connection definition input schema","description":"Resolve the input schema for a connection definition with the partial options the UI has so far. Includes an OAuth state token and the absolute server callback URL so the strategy can render an auth flow.","group":"ConnectionDefinition","method":"POST","path":"/connection-definition/:connectionDefinitionId/input-schema","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_connection_definition_input_schema","surface":"search"},"schemas":{"params":{"type":"object","properties":{"connectionDefinitionId":{"type":"string"}},"required":["connectionDefinitionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partialOptions":{"type":"object","additionalProperties":{}}},"required":["partialOptions"],"additionalProperties":false},"response":{"type":"object","properties":{"inputSchema":{}},"additionalProperties":false}}},{"key":"create-webhook-listener-definition","title":"Create webhook listener definition","description":"Create a webhook listener definition for an app.","group":"WebhookListenerDefinition","method":"POST","path":"/app/:appId/webhook-listener-definition","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_webhook_listener_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{"webhookListenerDefinition":{}},"additionalProperties":false}}},{"key":"delete-webhook-listener-definition","title":"Delete webhook listener definition","description":"Soft-delete a webhook listener definition. Listeners already created from it keep working; the definition just stops being offered. Requires deleteWebhookListenerDefinition.","group":"WebhookListenerDefinition","method":"DELETE","path":"/webhook-listener-definition/:webhookListenerDefinitionId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_webhook_listener_definition","surface":"search"},"schemas":{"params":{"type":"object","properties":{"webhookListenerDefinitionId":{"type":"string"}},"required":["webhookListenerDefinitionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-webhook-listener-definitions","title":"Get webhook listener definitions","description":"List all webhook listener definitions for an app.","group":"WebhookListenerDefinition","method":"GET","path":"/app/:appId/webhook-listener-definitions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_webhook_listener_definitions","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string"}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"webhookListenerDefinitions":{"type":"array","items":{}}},"required":["webhookListenerDefinitions"],"additionalProperties":false}}},{"key":"get-webhook-listener-definition-input-schema","title":"Get webhook listener definition input schema","description":"Resolve the IAutomationModuleInputSchema for a webhook listener definition given partial option inputs. Wraps `WebhookListenerDefinitionService.getWebhookListenerInputSchema`. Strategy errors are surfaced as KnownError.AutomationError (HTTP 5xx).","group":"WebhookListenerDefinition","method":"POST","path":"/webhook-listener-definition/:webhookListenerDefinitionId/input-schema","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_webhook_listener_definition_input_schema","surface":"search"},"schemas":{"params":{"type":"object","properties":{"webhookListenerDefinitionId":{"type":"string"}},"required":["webhookListenerDefinitionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partialOptions":{"type":"object","additionalProperties":{}}},"required":["partialOptions"],"additionalProperties":false},"response":{"type":"object","properties":{"inputSchema":{}},"additionalProperties":false}}},{"key":"get-advanced-input-items","title":"Get advanced input items","description":"List advanced-input items (text/table/image/list cells) attached to a specific (database item, property) pair.","group":"AdvancedInputItem","method":"GET","path":"/item/:databaseItemId/property/:propertyId/input-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_advanced_input_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"advancedInputItems":{"type":"array","items":{}}},"required":["advancedInputItems"],"additionalProperties":false}}},{"key":"create-advanced-input-item","title":"Create advanced input item","description":"Create an advanced-input cell of the given type for a (database item, property) pair. Empty `value` is normalized to \"\" — preserved verbatim.","group":"AdvancedInputItem","method":"POST","path":"/item/:databaseItemId/property/:propertyId/input-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_advanced_input_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"type":{"type":"string","enum":["text","table","image","list"]},"value":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"required":["type"],"additionalProperties":false},"response":{"type":"object","properties":{"advancedInputItem":{}},"additionalProperties":false}}},{"key":"update-advanced-input-item","title":"Update advanced input item","description":"Patch the value of an advanced-input cell.","group":"AdvancedInputItem","method":"PATCH","path":"/input-item/:advancedInputItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_advanced_input_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"advancedInputItemId":{"type":"string"}},"required":["advancedInputItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"value":{"anyOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string"},"minItems":1}]}},"required":["value"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-advanced-input-item","title":"Delete advanced input item","description":"Soft-delete an advanced-input cell.","group":"AdvancedInputItem","method":"DELETE","path":"/input-item/:advancedInputItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_advanced_input_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"advancedInputItemId":{"type":"string"}},"required":["advancedInputItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"add-database-relation-item","title":"Add a relation between database items","description":"Adds a relation entry from `databaseItemId` to `relatedDatabaseItemId` for the given relation property. If the property is configured `onlyOne`, any existing relations on the target item are soft-deleted first. Triggers value updates on dependants.","group":"DatabaseRelationProperty","method":"POST","path":"/item/:databaseItemId/property/:propertyId/related-item/:relatedDatabaseItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Add_a_relation_between_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"},"relatedDatabaseItemId":{"type":"string"}},"required":["databaseItemId","propertyId","relatedDatabaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-relation-item","title":"Remove a single relation between database items","description":"Soft-deletes the relation entry between `databaseItemId` and `relatedDatabaseItemId` for the given relation property. Triggers value updates on dependants.","group":"DatabaseRelationProperty","method":"DELETE","path":"/item/:databaseItemId/property/:propertyId/related-item/:relatedDatabaseItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Remove_a_single_relation_between_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"},"relatedDatabaseItemId":{"type":"string"}},"required":["databaseItemId","propertyId","relatedDatabaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-relation-items","title":"Remove all relations from a database item","description":"Soft-deletes every relation owned by `databaseItemId` for the given relation property and triggers value updates on dependants.","group":"DatabaseRelationProperty","method":"DELETE","path":"/item/:databaseItemId/property/:propertyId/related-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Remove_all_relations_from_a_database_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseItemId","propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-database-relation-items","title":"List related database items","description":"Returns the related database items for the given target item and relation property, with full cell values resolved.","group":"DatabaseRelationProperty","method":"GET","path":"/item/:databaseItemId/property/:propertyId/related-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_related_database_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"}},"required":["databaseItemId","propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databaseItems":{"type":"array","items":{}}},"required":["databaseItems"],"additionalProperties":false}}},{"key":"are-multiple-relations-selected","title":"Summarize the selections made on a relation property","description":"Returns how many active relations exist through the given relation property, and whether any single active item on the source database holds more than one of them.","group":"DatabaseRelationProperty","method":"GET","path":"/property/:propertyId/has-multiples","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Summarize_the_selections_made_on_a_relation_prop","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"areMultipleRelationsSelected":{"type":"boolean"},"selectedRelationCount":{"type":"number"}},"required":["areMultipleRelationsSelected","selectedRelationCount"],"additionalProperties":false}}},{"key":"will-reverse-relation-selection-remove-other-item","title":"Predict whether a reverse-relation selection will displace an existing pairing","description":"Returns true when selecting `relatedDatabaseItemId` on this reverse-relation property would steal the relation from another target item due to the foreign relation property being marked `onlyOne`.","group":"DatabaseRelationProperty","method":"GET","path":"/item/:databaseItemId/property/:propertyId/related-item/:relatedDatabaseItemId/will-remove-other-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Predict_whether_a_reverse-relation_selection_wil","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseItemId":{"type":"string"},"propertyId":{"type":"string"},"relatedDatabaseItemId":{"type":"string"}},"required":["databaseItemId","propertyId","relatedDatabaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"willRemoveOtherItem":{"type":"boolean"}},"required":["willRemoveOtherItem"],"additionalProperties":false}}},{"key":"get-relation-databases","title":"List databases that hold relations into a database","description":"Returns the databases whose properties hold a relation pointing into the given database, restricted to those with read permission for the requester.","group":"DatabaseRelationProperty","method":"GET","path":"/database/:databaseId/relation-databases","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_databases_that_hold_relations_into_a_databa","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseId":{"type":"string"}},"required":["databaseId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databases":{"type":"array","items":{}}},"required":["databases"],"additionalProperties":false}}},{"key":"get-resource-entity-settings-by-resource","title":"Get effective resource entity settings for the requesting entity on a resource","description":"Returns the requesting entity's effective resource entity settings (per-user/per-group customisations of a resource — e.g. notification preferences, view options) for the given resource, resolved through the parent resource hierarchy.","group":"ResourceEntitySetting","method":"GET","path":"/resource/:resourceType/:resourceId/entity-settings","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_effective_resource_entity_settings_for_the_r","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"required":["resourceId","resourceType"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"resourceEntitySettings":{"type":"array","items":{}}},"required":["resourceEntitySettings"],"additionalProperties":false}}},{"key":"update-resource-entity-settings-by-resource","title":"Update resource entity settings for the requesting entity on a resource","description":"Saves a batch of per-(entity, resource) settings (e.g. notification opt-in, view preferences). Each item is `{type, payload}`; the payload shape is determined by the type.","group":"ResourceEntitySetting","method":"PUT","path":"/resource/:resourceType/:resourceId/entity-settings","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_resource_entity_settings_for_the_requesti","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"required":["resourceId","resourceType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"resourceEntitySettings":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"disabled-notification-types"},"payload":{"type":"array","items":{"type":"object","properties":{"notificationChannelType":{"type":"string","enum":["desktop","mobile","mail"]},"disabledNotificationTypes":{"type":"array","items":{"type":"string","enum":["mentioned-in-message","replied-to-my-message","new-message","exported-database","incoming-call","database-item-value-updated","database-item-created","user-assigned-to-database-item","user-assignee-changed-on-database-item","status-changed-on-database-item","label-changed-on-database-item","database-item-deleted","cloud-item-created","cloud-item-deleted","mentioned-in-document","database-item-file-created","database-item-file-deleted","workspace-app-access-request-pending","workspace-permission-request-pending","app-version-published","date-changed-on-database-item","database-item-start-date-reminder","database-item-start-date-reached","database-item-end-date-reminder","database-item-end-date-passed"]}},"isInherited":{"type":"boolean"}},"required":["notificationChannelType","disabledNotificationTypes"],"additionalProperties":false}}},"required":["type","payload"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"disabled-watcher-types"},"payload":{"type":"array","items":{"type":"string","enum":["create-item","add-comment","edit-item","mentioned-in-comment","assigned-to-item"]}}},"required":["type","payload"],"additionalProperties":false}]},"maxItems":50}},"required":["resourceEntitySettings"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-automation-app-item","title":"Create automation app item","description":"Create a new automation-app item (automation step) under an automation app.","group":"AutomationAppItem","method":"POST","path":"/app/:appId/item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_automation_app_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string","minLength":1}},"required":["appId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"},"key":{"type":"string"},"automationAppItemGroupId":{"type":"string"},"description":{"type":"string"}},"required":["key"],"additionalProperties":false},"response":{"type":"object","properties":{"automationAppItem":{}},"additionalProperties":false}}},{"key":"get-automation-app-items","title":"Get automation app items","description":"List automation-app items under an automation app, ordered by position.","group":"AutomationAppItem","method":"GET","path":"/app/:appId/items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_automation_app_items","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appId":{"type":"string","minLength":1}},"required":["appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"automationAppItems":{"type":"array","items":{}}},"required":["automationAppItems"],"additionalProperties":false}}},{"key":"update-automation-app-item-position","title":"Update automation app item position","description":"Move an automation-app item to a new position (and optionally to a different group).","group":"AutomationAppItem","method":"PUT","path":"/app-item/:appAutomationId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_automation_app_item_position","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationId":{"type":"string","minLength":1}},"required":["appAutomationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"position":{"type":"number"},"automationAppItemGroupId":{"type":["string","null"]}},"required":["position"],"additionalProperties":false},"response":{"anyOf":[{"not":{}},{"type":"object","properties":{},"additionalProperties":false}]}}},{"key":"update-automation-app-item-name","title":"Update automation app item name","description":"Rename an automation-app item.","group":"AutomationAppItem","method":"PUT","path":"/app-item/:appAutomationId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_automation_app_item_name","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationId":{"type":"string","minLength":1}},"required":["appAutomationId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1}},"required":["name"],"additionalProperties":false},"response":{"anyOf":[{"not":{}},{"type":"object","properties":{},"additionalProperties":false}]}}},{"key":"delete-automation-app-item","title":"Delete automation app item","description":"Delete an automation-app item.","group":"AutomationAppItem","method":"DELETE","path":"/app-item/:appAutomationId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_automation_app_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"appAutomationId":{"type":"string","minLength":1}},"required":["appAutomationId"],"additionalProperties":false},"query":null,"body":null,"response":{"anyOf":[{"not":{}},{"type":"object","properties":{},"additionalProperties":false}]}}},{"key":"get-permissions-by-resource","title":"Get raw permission rows for a resource","description":"Returns the persisted permission rows targeting the given resource (per-entity entries that drove the effective permission map). Requires the resource read permission.","group":"Permission","method":"GET","path":"/permissions/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"permissions":{"type":"array","items":{}}},"required":["permissions"],"additionalProperties":false}}},{"key":"update-permissions-by-resource","title":"Bulk-update permissions on a resource","description":"Validates and applies a list of `{type, value, entityType, entityId?}` permission items on the given resource. Requires the resource admin permission. `InvalidPermissionValueError` is mapped to `INVALID_REQUEST` with `permissionType` payload.","group":"Permission","method":"PUT","path":"/permissions/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"permissions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"value":{},"entityType":{"type":"string","enum":["group","user","workspace-member","external-user","link","system","bot","app","agent"]},"entityId":{"type":["string","null"]}},"required":["type","entityType"],"additionalProperties":false}}},"required":["permissions"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-members-by-resource","title":"List users with read access to a resource","description":"Returns the users who currently have read access to the resource, sorted by recency of interaction (recent interactions on this resource first, then the requester's recent interactions in general).","group":"Permission","method":"GET","path":"/members/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"users":{"type":"array","items":{}}},"required":["users"],"additionalProperties":false}}},{"key":"get-entities-by-resource","title":"List entities (users / groups) with read access to a resource","description":"Returns users and/or groups with read access on the resource. Filter via `entityTypes` query (defaults to `[User, Group]`); pass `withMemberIds=true` to include `memberIds` on each group payload.","group":"Permission","method":"GET","path":"/entities/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":{"type":"object","properties":{"entityTypes":{"type":"array","items":{"type":"string","enum":["group","user","workspace-member","external-user","link","system","bot","app","agent"]}},"withMemberIds":{"type":"boolean"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"entities":{"type":"array","items":{}}},"required":["entities"],"additionalProperties":false}}},{"key":"get-user-permissions-by-resource","title":"Get the requesting user's effective permissions on a resource","description":"Returns the effective `{type, value}` permission map for the requesting entity on the given resource, computed across the resource hierarchy.","group":"Permission","method":"GET","path":"/me/permissions/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"permissions":{"type":"array","items":{}}},"required":["permissions"],"additionalProperties":false}}},{"key":"get-user-permissions-by-resources","title":"Bulk-fetch the requesting user's effective permissions across resources","description":"Returns effective permissions for a list of `{resourceType, resourceId}` pairs in one round-trip. Optimised: when consecutive resources share `resourceType`, the resource path is reused with the leaf resourceId swapped in.","group":"Permission","method":"POST","path":"/me/permissions","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false}}},"required":["resources"],"additionalProperties":false},"response":{"type":"object","properties":{"permissions":{"type":"array","items":{}}},"required":["permissions"],"additionalProperties":false}}},{"key":"get-members-by-all-parent-resources","title":"List users sharing a workspace with the requester (\"friends\")","description":"Returns the union of users that have read access to any workspace the requesting user is a member of. User-only.","group":"Permission","method":"GET","path":"/me/friends","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"users":{"type":"array","items":{}}},"required":["users"],"additionalProperties":false}}},{"key":"me","title":"Get current user","description":"Returns the authenticated user (or the guest entity if the request is anonymous).","group":"User","method":"GET","path":"/me","requiresAuthentication":true,"oauthScopes":["profile"],"mcp":{"toolName":"Get_current_user","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"user":{}},"additionalProperties":false}}},{"key":"delete-me","title":"Delete my account","description":"Anonymizes and removes the authenticated user account, deletes their sessions and API keys, and clears their avatar/cover files.","group":"User","method":"DELETE","path":"/me","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"null"}}},{"key":"get-my-workspaces","title":"Get my workspaces","description":"List workspaces the authenticated user has access to.","group":"User","method":"GET","path":"/me/workspaces","requiresAuthentication":true,"oauthScopes":["user.workspaces.read"],"mcp":{"toolName":"Get_my_workspaces","surface":"search"},"schemas":{"params":null,"query":{"type":"object","properties":{"skip":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"workspaces":{"type":"array","items":{}},"hasMore":{"type":"boolean"}},"required":["workspaces","hasMore"],"additionalProperties":false}}},{"key":"update-user-setting","title":"Update user setting","description":"Update a single user setting by name. The value is validated against the setting definition.","group":"User","method":"PUT","path":"/me/setting/:settingName","requiresAuthentication":true,"oauthScopes":["user.settings.write"],"mcp":{"toolName":"Update_user_setting","surface":"search"},"schemas":{"params":{"type":"object","properties":{"settingName":{"type":"string","minLength":1}},"required":["settingName"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"value":{}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-user-experimental-feature-flag","title":"Update experimental feature flag","description":"Toggle an experimental feature flag for the authenticated user.","group":"User","method":"PUT","path":"/me/experimental-feature-flag/:experimentalFeatureFlagType","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_experimental_feature_flag","surface":"search"},"schemas":{"params":{"type":"object","properties":{"experimentalFeatureFlagType":{"type":"string","enum":["use-html-in-database-table-view","show-database-views-in-sidebar","use-unified-space-switcher","use-unified-settings","show-unread-notification-count-in-sidebar","hide-bottom-sheet-overlay","enable-enhanced-notifications","enable-ai-autocomplete-in-documents","enable-collections","enable-agent-panel","enable-workspace-switcher-rail","enable-modern-database-view-header","enable-resource-header-search"]}},"required":["experimentalFeatureFlagType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"value":{"type":"boolean"}},"required":["value"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-user-nick","title":"Update user nickname","description":"Update the authenticated user nickname.","group":"User","method":"PUT","path":"/me/nick","requiresAuthentication":true,"oauthScopes":["user.profile.write"],"mcp":{"toolName":"Update_user_nickname","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"nick":{"type":"string"}},"required":["nick"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-user-mail","title":"Update user mail","description":"Update the authenticated user email address.","group":"User","method":"PUT","path":"/me/mail","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"mail":{"type":"string","format":"email"},"twoFactorVerificationId":{"type":"string","minLength":1},"twoFactorCode":{"type":"string","minLength":1}},"required":["mail"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-user-password","title":"Update user password","description":"Update the authenticated user password.","group":"User","method":"PUT","path":"/me/password","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"password":{"type":"string","minLength":8},"oldPassword":{"type":"string","minLength":1},"twoFactorVerificationId":{"type":"string","minLength":1},"twoFactorCode":{"type":"string","minLength":1}},"required":["password","oldPassword"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-user-status","title":"Update user status","description":"Update the authenticated user status (status text and status type).","group":"User","method":"PUT","path":"/me/status","requiresAuthentication":true,"oauthScopes":["user.status.write"],"mcp":{"toolName":"Update_user_status","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"statusText":{"type":["string","null"]},"statusType":{"type":"string","enum":["online","away","busy","offline"]}},"required":["statusText","statusType"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"patch-user","title":"Patch current user","description":"Patch fields on the authenticated user that are not part of user settings.","group":"User","method":"PATCH","path":"/me","requiresAuthentication":true,"oauthScopes":["user.profile.write"],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"lastChangelogVisitedAt":{"type":"object","additionalProperties":{"type":"string","format":"date-time"}}},"required":["lastChangelogVisitedAt"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-user-sessions","title":"Get my sessions","description":"Paginated list of active sessions for the authenticated user.","group":"User","method":"GET","path":"/me/sessions","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_my_sessions","surface":"search"},"schemas":{"params":null,"query":{"type":"object","properties":{"skip":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"sessions":{"type":"array","items":{}},"totalCount":{"type":"number"}},"required":["sessions","totalCount"],"additionalProperties":false}}},{"key":"update-user-onboarding-role-and-discover","title":"Update user onboarding role and discover source","description":"Save user role and discover source during onboarding.","group":"User","method":"PUT","path":"/me/onboarding/role-and-discover","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"role":{"type":"string","enum":["founder-owner","c-level","director","team-leader","team-member","project-manager","consultant","freelancer"]},"discoverSource":{"type":"string","enum":["linkedin","youtube","facebook","tiktok","google-search","online-ads","friend-colleague","software-review-site"]}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"skip-user-onboarding-step","title":"Skip user onboarding step","description":"Mark a user-level onboarding step as skipped.","group":"User","method":"PUT","path":"/me/onboarding/skip/:onboardingStepType","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"onboardingStepType":{"type":"string","enum":["workspace-customization","company-info","core-areas","solutions","invite","role-and-discover","generate-workspace","profile-customization"]}},"required":["onboardingStepType"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"complete-user-onboarding","title":"Complete user onboarding","description":"Records when the authenticated user finished the onboarding wizard for the first time. Idempotent.","group":"User","method":"PUT","path":"/me/onboarding/complete","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-available-llm-tools","title":"Get available LLM tools","description":"List the LLM tools the authenticated user can pre-authorize in their settings.","group":"User","method":"GET","path":"/me/available-llm-tools","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"group":{"type":"string"},"isWrite":{"type":"boolean"}},"required":["name","title","description","group","isWrite"],"additionalProperties":false}}},"required":["tools"],"additionalProperties":false}}},{"key":"get-activity-log-by-resource","title":"Get activity log for a resource","description":"Lists activity items associated with a given resource (paginated, optionally filtered by activity log filters).","group":"ActivityLog","method":"POST","path":"/activity/:resourceType/:resourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_activity_log_for_a_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"required":["resourceId","resourceType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"offset":{"type":"number","minimum":0},"limit":{"type":"number","minimum":1,"maximum":100},"filterItems":{"type":"array"}},"required":["offset","limit"],"additionalProperties":false},"response":{"type":"object","properties":{"activityItems":{"type":"array"}},"required":["activityItems"],"additionalProperties":false}}},{"key":"revert-activity-item","title":"Revert an activity item","description":"Reverts the side effects of a single activity item if its strategy supports revert. Marks the activity item as reverted and emits the corresponding socket events.","group":"ActivityLog","method":"PUT","path":"/activity/:activityItemId/revert","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"activityItemId":{"type":"string"}},"required":["activityItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"revert-delete-activity-item-by-resource-id","title":"Restore a deleted resource by id","description":"Undeletes a resource item by id, reverts the matching deletion activity, and re-emits a ResourceItemCreated activity for the restored resource.","group":"ActivityLog","method":"PUT","path":"/activity/:resourceId/revertByResourceId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Restore_a_deleted_resource_by_id","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceId":{"type":"string"}},"required":["resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"includeItems":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"revert-activity-items-by-database-item-ids","title":"Revert deletion activity for database items","description":"Bulk-reverts DatabaseItemDeleted activities for the supplied database item ids and emits restored events.","group":"ActivityLog","method":"PUT","path":"/activity/revertByDatabaseItemIds","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"databaseItemIds":{"type":"array","items":{"type":"string"}}},"required":["databaseItemIds"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-activity-unique-entities-by-resource","title":"List entities authoring activity on a resource","description":"Returns the unique set of users (plus the System entity) that have authored activity for the given resource. Combines members with read access and historical activity authors.","group":"ActivityLog","method":"GET","path":"/activity/:resourceType/:resourceId/unique-entities","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_entities_authoring_activity_on_a_resource","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]}},"required":["resourceId","resourceType"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"entities":{"type":"array"}},"required":["entities"],"additionalProperties":false}}},{"key":"get-workspace-trash-items","title":"Get workspace trash items","description":"Get soft-deleted resources and database columns of a workspace that can still be restored","group":"WorkspaceTrash","method":"GET","path":"/workspace/:workspaceId/trash-items","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"offset":{"type":"number","minimum":0,"default":0},"limit":{"type":"number","minimum":1,"maximum":100,"default":50},"deletedFrom":{"type":"string","format":"date-time"},"deletedTo":{"type":"string","format":"date-time"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"trashItems":{"type":"array","items":{"type":"object","properties":{"trashItemType":{"type":"string","enum":["resource","database","databaseProperty"]},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"resourceItemId":{"type":"string"},"name":{"type":"string"},"parentName":{"type":"string"},"deletedAt":{"type":"string","format":"date-time"},"deletedBy":{"type":"object","properties":{"entityType":{"type":"string","enum":["bot","user","system","guest","app","agent"]},"entityId":{"type":"string"},"payload":{}},"required":["entityType"],"additionalProperties":false}},"required":["trashItemType","resourceType","resourceId","deletedAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["trashItems","hasMore"],"additionalProperties":false}}},{"key":"restore-workspace-trash-item","title":"Restore workspace trash item","description":"Restore a soft-deleted database or database column from the workspace trash","group":"WorkspaceTrash","method":"POST","path":"/workspace/:workspaceId/trash-items/restore","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"trashItemType":{"type":"string","enum":["resource","database","databaseProperty"]},"resourceId":{"type":"string"},"includeItems":{"type":"boolean"}},"required":["trashItemType","resourceId"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-message","title":"Create message","description":"Send a new message in a conversation. The conversation is identified by `conversationType` (path) + `conversationTypePayload` (body), e.g. a database-item activity feed, direct conversation, or call.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/message","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"content":{"type":"array"},"replyMessageId":{"type":["string","null"]},"state":{"type":"string","enum":["draft","sent"]},"callId":{"type":["string","null"]},"llmModelKey":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"get-messages","title":"Get messages","description":"Paginated list of messages for a conversation. Reverse-ordered (newest first internally, returned newest-last after .reverse()). Use `skip` for pagination.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/messages","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_messages","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"skip":{"type":"number"},"messageId":{"type":["string","null"]},"callId":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"messages":{"type":"array"}},"required":["messages"],"additionalProperties":false}}},{"key":"get-messages-authors","title":"Get messages authors","description":"List the unique author entities (Users) that have posted in a given conversation.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/messages-authors","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_messages_authors","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{}},"additionalProperties":false},"response":{"type":"object","properties":{"messagesAuthors":{"type":"array"}},"required":["messagesAuthors"],"additionalProperties":false}}},{"key":"get-message","title":"Get message","description":"Fetch a single message by its ID.","group":"Message","method":"GET","path":"/message/:messageId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"delete-message","title":"Delete message","description":"Permanently delete a message you sent. Confirm before calling - this is destructive. Updates lastReadMessageId references on affected ConversationMessageEntity rows.","group":"Message","method":"DELETE","path":"/message/:messageId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"update-message","title":"Update message","description":"Edit a message (content) and/or transition its state (Draft → Sent). Empty content on a no-files message deletes it. Sending a draft fires the conversation strategy afterMessageCreated hook.","group":"Message","method":"PATCH","path":"/message/:messageId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"content":{"type":"array"},"state":{"type":"string","enum":["draft","sent"]},"llmModelKey":{"type":["string","null"]}},"additionalProperties":false},"response":{}}},{"key":"approve-llm-tool-used","title":"Approve LLM tool used","description":"Approve a pending LlmToolUsed message — moves it to Running status and schedules the ProcessApprovedLlmToolUsedJob. Only the requesting entity can approve.","group":"Message","method":"POST","path":"/message/:messageId/approve-llm-tool-used","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"reject-llm-tool-used","title":"Reject LLM tool used","description":"Reject a pending LlmToolUsed message — marks it Rejected with an error message and continues the LLM run without calling the tool. Only the requesting entity can reject.","group":"Message","method":"POST","path":"/message/:messageId/reject-llm-tool-used","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"message":{}},"additionalProperties":false}}},{"key":"bulk-resolve-llm-tools-used","title":"Bulk resolve LLM tools used","description":"Approve or reject ALL pending LlmToolUsed messages for a given trigger message in one atomic operation, then schedule a single ProcessApprovedLlmToolUsedJob that resumes the run once every tool is resolved. Only the requesting entity can resolve.","group":"Message","method":"POST","path":"/message/:messageId/bulk-resolve-llm-tools-used","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"action":{"type":"string","enum":["approve","reject"]},"scope":{"type":"string","enum":["session","always","always-scoped"]}},"required":["action"],"additionalProperties":false},"response":{"type":"object","properties":{"resolvedCount":{"type":"number"}},"required":["resolvedCount"],"additionalProperties":false}}},{"key":"get-session-tool-permissions","title":"Get session tool permissions","description":"List the LLM tool names the requesting entity has allowed for the current session (this conversation).","group":"Message","method":"POST","path":"/conversation-type/:conversationType/session-tool-permissions","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{}},"additionalProperties":false},"response":{"type":"object","properties":{"toolNames":{"type":"array","items":{"type":"string"}}},"required":["toolNames"],"additionalProperties":false}}},{"key":"revoke-session-tool-permissions","title":"Revoke session tool permissions","description":"Remove a session tool grant (or all of them) the requesting entity has allowed for the current conversation.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/session-tool-permissions/revoke","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"toolName":{"type":"string","minLength":1}},"additionalProperties":false},"response":{"type":"object","properties":{"removedCount":{"type":"number"}},"required":["removedCount"],"additionalProperties":false}}},{"key":"stop-llm-response","title":"Stop LLM response","description":"Stop an in-flight LLM response by stamping stopRequestedAt on all running jobs for the message owned by the calling entity.","group":"Message","method":"POST","path":"/message/:messageId/stop-llm-response","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"upload-file-to-message","title":"Upload file to message","description":"Multipart upload to attach a file to a message. Not callable through the typed adapter pipeline.","group":"Message","method":"POST","path":"/message/:messageId/file","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"file":{}},"additionalProperties":false}}},{"key":"delete-file-from-message","title":"Delete file from draft message","description":"Remove a file attachment from a Draft-state message.","group":"Message","method":"DELETE","path":"/message-file/:fileId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_file_from_draft_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"fileId":{"type":"string"}},"required":["fileId"],"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"delete-file-from-sent-message","title":"Delete file from sent message","description":"Remove a file attachment from a Sent-state message you own. If the message has no remaining content/files, the whole message is deleted.","group":"Message","method":"DELETE","path":"/message/:messageId/file/:fileId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_file_from_sent_message","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"},"fileId":{"type":"string"}},"required":["messageId","fileId"],"additionalProperties":false},"query":null,"body":null,"response":{}}},{"key":"mark-messages-as-read","title":"Mark messages as read","description":"Update the per-user read pointer in a conversation. Schedules a debounced UpdateMessageReadStatusJob and emits MessagesRead.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/mark-messages-as-read","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_messages_as_read","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"callId":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"lastUnreadMessageId":{"type":["string","null"]},"unreadCount":{"type":"number"},"lastReadMessageId":{"type":["string","null"]},"newLastReadMessageId":{"type":["string","null"]}},"required":["lastUnreadMessageId","unreadCount","lastReadMessageId","newLastReadMessageId"],"additionalProperties":false}}},{"key":"mark-messages-as-unread","title":"Mark messages as unread","description":"Rewind the per-user read pointer in a conversation so its newest message reads as unread. Schedules a debounced UpdateMessageReadStatusJob.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/mark-messages-as-unread","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_messages_as_unread","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{},"callId":{"type":["string","null"]}},"additionalProperties":false},"response":{"type":"object","properties":{"lastReadMessageId":{"type":["string","null"]},"unreadCount":{"type":"number"}},"required":["lastReadMessageId","unreadCount"],"additionalProperties":false}}},{"key":"get-conversation-context","title":"Get conversation context","description":"Fetch the conversation-strategy-derived context object for a conversation (e.g. resource details, members) — useful before posting or summarizing.","group":"Message","method":"POST","path":"/conversation-type/:conversationType/context","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_conversation_context","surface":"search"},"schemas":{"params":{"type":"object","properties":{"conversationType":{"type":"string","enum":["database-cell","database-file","cloud-file","workspace","direct","call-room"]}},"required":["conversationType"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"conversationTypePayload":{}},"additionalProperties":false},"response":{"type":"object","properties":{"conversationContext":{}},"additionalProperties":false}}},{"key":"get-message-read-entities","title":"Get message read entities","description":"List the entities (typically Users) that have read a given message, with a total count.","group":"Message","method":"GET","path":"/message/:messageId/read-entities","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_message_read_entities","surface":"search"},"schemas":{"params":{"type":"object","properties":{"messageId":{"type":"string"}},"required":["messageId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"entities":{"type":"array"},"totalCount":{"type":"number"}},"required":["entities","totalCount"],"additionalProperties":false}}},{"key":"update-operating-system-data","title":"Update operating system data on current session","description":"Persist the caller-provided OS payload (e.g. APN/FCM device tokens, push capabilities) onto the currently authenticated Session document. Throws Forbidden when the request has no resolvable session id.","group":"CurrentSession","method":"PUT","path":"/me/current-session/operating-system-data","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"operatingSystemData":{}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-ringing-call-invites","title":"Get ringing call invites","description":"List call invites currently ringing for the authenticated user.","group":"CallInvite","method":"GET","path":"/call-invites/ringing","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"callInvites":{"type":"array","items":{}}},"required":["callInvites"],"additionalProperties":false}}},{"key":"accept-call-invite","title":"Accept call invite","description":"Accept a ringing call invite for the current user. Emits CallInviteUpdated over the global socket so other devices see the state change.","group":"CallInvite","method":"POST","path":"/call-invites/:callInviteId/accept","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"callInviteId":{"type":"string"}},"required":["callInviteId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"callInvite":{}},"additionalProperties":false}}},{"key":"decline-call-invite","title":"Decline call invite","description":"Decline a ringing call invite for the current user. Emits CallInviteUpdated over the global socket so other devices see the state change.","group":"CallInvite","method":"POST","path":"/call-invites/:callInviteId/decline","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"callInviteId":{"type":"string"}},"required":["callInviteId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"callInvite":{}},"additionalProperties":false}}},{"key":"create-status","title":"Create status","description":"Create a new status option on a status-capable database property. Requires updateDatabaseProperty permission. Auto-assigns a non-conflicting palette color when none is provided; rejects duplicate titles within the property. Call this after creating a status property, once per option, then read the option IDs back with get_database_property_possible_values before writing any cell.","group":"Status","method":"POST","path":"/property/:propertyId/status","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"create_status","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","minLength":1},"color":{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},"position":{"type":"number"}},"required":["title"],"additionalProperties":false},"response":{"type":"object","properties":{"status":{}},"additionalProperties":false}}},{"key":"delete-status","title":"Delete status","description":"Delete a status option from a database property. Requires updateDatabaseProperty permission. Refuses if the status is currently in use by any database item, or if it does not belong to the property. Resequences positions of remaining statuses and emits StatusUpdated/StatusDeleted activity items.","group":"Status","method":"DELETE","path":"/status/:statusId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_status","surface":"search"},"schemas":{"params":{"type":"object","properties":{"statusId":{"type":"string"}},"required":["statusId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-property-statuses","title":"Get property statuses","description":"List statuses for a status-typed database property, sorted by position. Requires readDatabaseProperty permission. Resolves source property via PropertyTypeStrategy to support derived/relation properties.","group":"Status","method":"GET","path":"/property/:propertyId/statuses","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_property_statuses","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"}},"required":["propertyId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"statuses":{"type":"array","items":{}}},"required":["statuses"],"additionalProperties":false}}},{"key":"update-status","title":"Update status","description":"Patch title/color/position/groupType on a status. Requires updateDatabaseProperty permission. Position changes resequence sibling statuses. groupType change schedules UpdateStatusGroupInDatabaseItemsJob; color/title change schedules UpdateRelatedPropertiesJob.","group":"Status","method":"PATCH","path":"/status/:statusId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_status","surface":"search"},"schemas":{"params":{"type":"object","properties":{"statusId":{"type":"string"}},"required":["statusId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string","minLength":1},"color":{},"position":{"type":"number"},"groupType":{"type":"string","enum":["not_started","active","completed","closed","other"]}},"additionalProperties":false},"response":{"type":"object","properties":{"status":{}},"additionalProperties":false}}},{"key":"global-search","title":"Global search","description":"Search every accessible resource (databases, items, dashboards, automations, ...) inside a workspace, dispatching to per-resource-type GlobalSearchStrategy implementations and merging the results up to `limit` (default 20). Empty/missing query returns an empty result set without touching strategies.","group":"GlobalSearch","method":"GET","path":"/workspace/:workspaceId/global-search","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Global_search","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"results":{"type":"array","items":{}}},"required":["results"],"additionalProperties":false}}},{"key":"create-database-time-tracker-item","title":"Start a time tracker entry on an item","description":"Creates a time tracker entry under a property/item; if `shouldStartOnCreate` is true, ends every active entry for the requester first and tracks this one as active. Emits a DatabaseTimeTrackerItemCreated activity and triggers value updates on dependants. Lock-guarded per requesting entity.","group":"DatabaseTimeTrackerItem","method":"POST","path":"/item/:databaseItemId/property/:propertyId/time-tracker-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Start_a_time_tracker_entry_on_an_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"shouldStartOnCreate":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseTimeTrackerItem":{}},"additionalProperties":false}}},{"key":"create-my-database-time-tracker-item","title":"Start a personal time tracker entry","description":"Creates a time tracker entry for the requester. When `shouldStartOnCreate` is true (default), ends every active entry first and starts this one as active. When false, creates a finished manual entry with `endedAt=now` without interrupting the active session. `databaseItemId` is optional; when omitted the entry starts unassigned and can be linked later via update. Lock-guarded per requesting entity.","group":"DatabaseTimeTrackerItem","method":"POST","path":"/me/time-tracker-item","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Start_a_personal_time_tracker_entry","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"databaseItemId":{"type":["string","null"]},"databasePropertyId":{"type":["string","null"]},"shouldStartOnCreate":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseTimeTrackerItem":{}},"additionalProperties":false}}},{"key":"search-my-time-tracker-database-items","title":"Search database items with time tracker properties","description":"Searches database items across every workspace the requester can access, limited to databases that have a time tracker property and filtered by read permissions. Returns name, workspace, database, and databaseItemId for autocomplete.","group":"DatabaseTimeTrackerItem","method":"POST","path":"/me/time-tracker-database-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Search_database_items_with_time_tracker_properti","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"search":{"type":"string","maxLength":200},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":50},"offset":{"type":"integer","minimum":0,"maximum":1000},"workspaceId":{"type":"string"}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseItems":{"type":"array","items":{}}},"required":["databaseItems"],"additionalProperties":false}}},{"key":"get-my-database-time-tracker-items","title":"List personal time tracker entries","description":"Returns time tracker entries authored by the requester, optionally filtered by date range and assignment status (assigned / unassigned to a database item).","group":"DatabaseTimeTrackerItem","method":"POST","path":"/me/time-tracker-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_personal_time_tracker_entries","surface":"search"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"dateRange":{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string"},{"type":"string"}]},"assignmentFilter":{"type":"string","enum":["assigned","unassigned"]},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":100},"offset":{"type":"integer","minimum":0}},"additionalProperties":false},"response":{"type":"object","properties":{"databaseTimeTrackerItems":{"type":"array","items":{}},"authorEntity":{},"hasMore":{"type":"boolean"}},"required":["databaseTimeTrackerItems","hasMore"],"additionalProperties":false}}},{"key":"get-database-time-tracker-items","title":"List time tracker entries for an item/property","description":"Returns the time tracker entries logged under the given property and database item, including their author entity.","group":"DatabaseTimeTrackerItem","method":"GET","path":"/item/:databaseItemId/property/:propertyId/time-tracker-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_time_tracker_entries_for_an_item_property","surface":"search"},"schemas":{"params":{"type":"object","properties":{"propertyId":{"type":"string"},"databaseItemId":{"type":"string"}},"required":["propertyId","databaseItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"databaseTimeTrackerItems":{"type":"array","items":{}}},"required":["databaseTimeTrackerItems"],"additionalProperties":false}}},{"key":"get-all-database-time-tracker-items","title":"Search time tracker entries","description":"Returns the time tracker entries authored by `userId`, optionally narrowed by property, workspace, database, and a `[start, end]` date range.","group":"DatabaseTimeTrackerItem","method":"POST","path":"/:resourceType/:resourceId/time-tracker-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Search_time_tracker_entries","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"dateRange":{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string"},{"type":"string"}]},"userId":{"type":"string"},"propertyId":{"type":"string"},"workspaceId":{"type":"string"},"databaseId":{"type":"string"}},"required":["userId"],"additionalProperties":false},"response":{"type":"object","properties":{"databaseTimeTrackerItems":{"type":"array","items":{}}},"required":["databaseTimeTrackerItems"],"additionalProperties":false}}},{"key":"update-database-time-tracker-item","title":"Edit a time tracker entry","description":"Updates start/end time or reassigns `databaseItemId` (including null to unassign) on the author's entry. Active entries allow editing `startedAt` only; `endedAt` requires a finished entry. Item reassignment triggers value updates on previous/next items.","group":"DatabaseTimeTrackerItem","method":"PATCH","path":"/time-tracker-item/:databaseTimeTrackerItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Edit_a_time_tracker_entry","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseTimeTrackerItemId":{"type":"string"}},"required":["databaseTimeTrackerItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-database-time-tracker-item","title":"Delete a time tracker entry","description":"Soft-deletes a time tracker entry. Only the original author may delete. Emits a DatabaseTimeTrackerItemDeleted activity and triggers value updates on dependants.","group":"DatabaseTimeTrackerItem","method":"DELETE","path":"/time-tracker-item/:databaseTimeTrackerItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_a_time_tracker_entry","surface":"search"},"schemas":{"params":{"type":"object","properties":{"databaseTimeTrackerItemId":{"type":"string"}},"required":["databaseTimeTrackerItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"end-all-database-time-tracker-items","title":"End all my active time tracker entries","description":"Stops all currently-active time tracker entries owned by the requesting entity. Lock-guarded per requesting entity.","group":"DatabaseTimeTrackerItem","method":"DELETE","path":"/me/active-time-tracker-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"End_all_my_active_time_tracker_entries","surface":"search"},"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"get-resource-items","title":"List resource items in a workspace","description":"Returns the resource items the requesting user can read in the workspace, with read-state, unseen-notification counts, and favourite metadata. User-only.","group":"ResourceItem","method":"GET","path":"/workspace/:workspaceId/resource-items","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_resource_items_in_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"resourceItems":{"type":"array"}},"required":["resourceItems"],"additionalProperties":false}}},{"key":"mark-resource-as-read","title":"Mark a resource as read","description":"Records the requesting user has read the resource at the current time and emits a `ResourceReadAtChange` socket event to that user.","group":"ResourceItem","method":"POST","path":"/resource/:resourceType/:resourceId/mark-as-read","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_a_resource_as_read","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"mark-resource-as-unread","title":"Mark a resource as unread","description":"Clears the requesting user's read mark on the resource, putting it back in the unread state, and emits a `ResourceReadAtChange` socket event with a null `readAt` to that user.","group":"ResourceItem","method":"POST","path":"/resource/:resourceType/:resourceId/mark-as-unread","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Mark_a_resource_as_unread","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"toggle-resource-item-favourite","title":"Toggle favourite on a resource for the requesting user","description":"Marks or unmarks a resource as a favourite for the requesting user; favouriting a database view also creates the missing parent ResourceItem so it can appear in lists. User-only.","group":"ResourceItem","method":"POST","path":"/resource/:resourceType/:resourceId/favourite","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Toggle_favourite_on_a_resource_for_the_requestin","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"isFavourite":{"type":"boolean"}},"required":["isFavourite"],"additionalProperties":false},"response":{"type":"object","properties":{"isFavourite":{"type":"boolean"}},"required":["isFavourite"],"additionalProperties":false}}},{"key":"update-entity-resource-item","title":"Update favourite position or color for the requesting user","description":"Updates per-user favourite metadata (position within favourites list, color) for an existing favourite EntityResourceItem; reorders sibling favourites accordingly. User-only.","group":"ResourceItem","method":"PATCH","path":"/resource/:resourceType/:resourceId/entity-resource-item","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"position":{"type":"number"},"color":{}},"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-resource-item-position","title":"Move a resource item between groups, spaces, or positions","description":"Updates the position, resource group, and/or resource space of a resource item; emits a ResourceItemPositionUpdated activity for every affected sibling.","group":"ResourceItem","method":"PUT","path":"/resource-item/:resourceItemId/position","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Move_a_resource_item_between_groups_spaces_or_po","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceItemId":{"type":"string"}},"required":["resourceItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"position":{"type":"number"},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]}},"required":["position"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-resource-item","title":"Delete a resource item","description":"Soft-deletes a resource item via ResourceItemService (which cascades into the underlying resource per resource-type strategy). DESTRUCTIVE.","group":"ResourceItem","method":"DELETE","path":"/resource-item/:resourceItemId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_a_resource_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceItemId":{"type":"string"}},"required":["resourceItemId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-resource-item-name","title":"Rename a resource item","description":"Renames the underlying resource via ResourceItemService.updateResourceItemName, which also emits the appropriate rename activity per resource type.","group":"ResourceItem","method":"PUT","path":"/resource-item/:resourceItemId/name","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Rename_a_resource_item","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceItemId":{"type":"string"}},"required":["resourceItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"update-resource-item-icon","title":"Update a resource item icon","description":"Updates the underlying resource icon via ResourceItemService.updateResourceItemIcon and denormalizes ResourceItem.iconNameType.","group":"ResourceItem","method":"PUT","path":"/resource-item/:resourceItemId/icon","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_a_resource_item_icon","surface":"search"},"schemas":{"params":{"type":"object","properties":{"resourceItemId":{"type":"string"}},"required":["resourceItemId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"iconNameType":{"anyOf":[{"type":"string","enum":["plus","h","align-left","closed-captioning","chevron-up","chevron-down","trash","eye","eye-slash","ellipsis","folder-open","folder-closed","house","clock","pen","caret-right","caret-down","circle-dot","empty-set","caret-up","calendar-days","user-plus","user","headphones","rectangle-history","brain","rectangle-history-circle-plus","user-secret","down","gear","comment-dot","clock-rotate-left","clone","circle-up","circle-down","compress","bars-filter","filter","lock","link","video","broom-wide","arrow-up-short-wide","arrow-down-short-wide","file-import","file-export","arrow-right-to-line","sort","arrow-down","arrow-up","layer-group","list","ban","thumbtack","earth-americas","floppy-disk","gears","copy","scissors","table","table-cells-rows","location-dot","align-justify","calendar","columns-3","anchor","signal-stream","chevron-right","chevron-left","pizza-slice","ellipsis-vertical","left-to-bracket","upload","arrow-down-to-bracket","up-to-bracket","paper-plane","circle-plus","pen-line","arrow-up-arrow-down","right-to-bracket","rotate-left","rotate-right","magnifying-glass-minus","magnifying-glass-plus","maximize","minimize","download","database","comment-lines","comment-exclamation","comment-quote","microphone","grid-2","bolt","folder","square-check","square","bars-sort","sidebar","sidebar-flip","text","grip-vertical","arrow-down-1-9","clipboard-check","feather","user-vneck","user-vneck-hair","face-grin","user-alien","face-rolling-eyes","alien","star","comment-middle","file","tags","phone","phone-volume","at","location-pin","arrow-up-right-from-square","arrow-up-right","arrow-down-right","arrow-down-left","link-simple","wand-magic-sparkles","calculator","stopwatch","circle-1","xmark","robot","file-image","shield","file-audio","file-video","file-pdf","file-spreadsheet","file-code","file-csv","file-lines","chevrons-left","chevrons-right","xmark-large","bars-staggered","envelope","alarm-snooze","diagram-subtask","magnifying-glass","spinner","stop","phone-xmark","reply","share","power-off","angle-left","location-arrow","expand","circle-nodes","code","rectangle-vertical-history","play","comment","comment-plus","file-arrow-up","face-smile","pen-to-square","windows","linux","apple","google","github","facebook","pause","times","check","google-play","camera","camera-slash","microphone-slash","phone-slash","desktop","desktop-slash","droplet","droplet-slash","up","left","right","arrow-rotate-left","user-group","angles-left","bell","circle-info","bell-slash","arrow-down-to-line","square-terminal","minus","volume-slash","volume-high","volume","volume-low","arrow-rotate-right","paperclip","share-nodes","angles-right","address-book","book","grip","rotate-reverse","rotate","crown","location-crosshairs","message","message-lines","location-smile","location-exclamation","location-plus","location-xmark","location-pin-alt","map-pin","circle-star","heart","circle-user","user-helmet-safety","screwdriver-wrench","traffic-cone","car","handshake","file-signature","house-chimney-blank","industry","industry-windows","building-user","car-building","square-h","fork-knife","building","bullseye-arrow","bullseye","crosshairs-simple","flag-pennant","flag","flag-swallowtail","bookmark","circle-bookmark","sparkle","hypris-rightsidebar","hypris-minimalize","hypris-overlay","caret-left","calendar-lines","hourglass","dash","map","diamond-turn-right","display","display-slash","wifi","phone-hangup","hyphen","rocket","files","square-question","draw-polygon","pen-ruler","window-restore","arrow-right","arrow-left","exclamation-circle","flask","sun","moon","cog","globe","home","wrench","marker","brackets-curly","angle-down","quote-left","angle-double-right","question","angles-up","angles-down","exclamation-triangle","calendar-plus","calendar-pen","angle-right","ghost","snooze","sliders-v","font-case","image","triangle-exclamation","save","palette","align-center","align-right","sort-circle","qrcode","up-right-and-down-left-from-center","sort-up","sort-down","turn-down-left","file-chart-pie","chart-line","chart-pie","chart-bar","file-contract","file-invoice-dollar","file-invoice","clipboard","clipboard-list","file-medical","file-certificate","user-tie","user-tie-hair-long","user-nurse","user-doctor","user-gear","users","handshake-angle","briefcase","suitcase","people-group","store","shop","warehouse","hotel","hospital","school","university","church","store-alt","tree","leaf","paw","truck","bus","taxi","train","subway","ship","plane","bicycle","motorcycle","gas-pump","truck-moving","truck-fast","shipping-fast","utensils","burger","coffee","martini-glass","wine-bottle","beer-mug-empty","apple-whole","fish","bread-slice","cake-candles","shopping-cart","bag-shopping","basket-shopping","box","boxes-stacked","box-open","box-archive","cash-register","receipt","credit-card","money-bill","wallet","money-check-dollar","piggy-bank","scale-balanced","calendar-check","mobile","laptop","tablet","comments","address-card","compass","medal","award","shield-halved","lightbulb","outlet","globe-europe","arrows-rotate","arrow-pointer","hand-back-fist","hammer","note-sticky","object-group","object-ungroup","diagram-project","delete-left","pen-fancy","highlighter","eraser","copyright","circle-question","webhook","brackets-square","list-check","Pencil","cat","dog","horse","hippo","otter","dragon","kiwi-bird","worm","locust","spider","bug","bugs","dove","frog","crow","lizard","snail","shrimp","mosquito","node-js","golang","python","php","java","rust","swift","microsoft","chrome","dart-lang","phoenix-framework","android","gem","thumbs-up"]},{"type":"null"}]}},"required":["iconNameType"],"additionalProperties":false},"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"generate-resources","title":"Generate resources","description":"Create resources in a workspace from a plain-language prompt: databases with columns and sample rows, documents with written content, whiteboards, conversations, calls, dashboards, folders, automations, apps, skills and agents. resourceTypes lists the kinds the model may create; it creates only what the prompt asks for, in the numbers the prompt names. Resources are created right away in the workspace, or inside the given resource group or space, each with a sidebar entry. Returns the created resources with their ids and names.","group":"Resource","method":"POST","path":"/workspaces/:workspaceId/resources/generate","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Generate_resources","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"prompt":{"type":"string","minLength":3,"maxLength":2000},"resourceTypes":{"type":"array","items":{"type":"string","enum":["database","document","whiteboard","conversation","call-room","dashboard","folder","automation","app","skill","agent"]},"minItems":1},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]}},"required":["prompt","resourceTypes"],"additionalProperties":false},"response":{"type":"object","properties":{"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"name":{"type":"string"}},"required":["resourceType","resourceId","name"],"additionalProperties":false}}},"required":["resources"],"additionalProperties":false}}},{"key":"retry-workspace-subscription-payment","title":"Retry workspace subscription payment","description":"Retry the outstanding subscription payment for a workspace using its current default payment method. This is the only way a payment-suspended workspace can unblock itself, so it stays callable while the workspace is suspended.","group":"WorkspaceSubscription","method":"POST","path":"/workspace/:workspaceId/subscription/retry-payment","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"status":{"type":"string","enum":["readyToCollect","collecting","paid","failed","requiresAction"]}},"required":["status"],"additionalProperties":false}}},{"key":"cancel-workspace-subscription-renewal","title":"Cancel workspace subscription renewal","description":"Cancel the auto-renewal for a workspace subscription at the end of the current billing period.","group":"WorkspaceSubscription","method":"POST","path":"/workspace/:workspaceId/subscription/cancel-renewal","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"reason":{"type":"string","minLength":1},"note":{"type":["string","null"]}},"required":["reason"],"additionalProperties":false},"response":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}},{"key":"resume-workspace-subscription-renewal","title":"Resume workspace subscription renewal","description":"Re-enable auto-renewal for a workspace subscription that was previously scheduled for cancellation.","group":"WorkspaceSubscription","method":"POST","path":"/workspace/:workspaceId/subscription/resume-renewal","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}},{"key":"list-call-backgrounds","title":"List call backgrounds","description":"List the call backgrounds uploaded by the authenticated user, newest first.","group":"CallBackground","method":"GET","path":"/me/call-backgrounds","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"backgrounds":{"type":"array"}},"required":["backgrounds"],"additionalProperties":false}}},{"key":"create-call-background","title":"Upload call background","description":"Upload a new call background image for the authenticated user (file upload not supported in MCP). Enforces a per-user backgrounds limit.","group":"CallBackground","method":"POST","path":"/me/call-backgrounds","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"background":{}},"additionalProperties":false}}},{"key":"delete-call-background","title":"Delete call background","description":"Delete a call background owned by the authenticated user.","group":"CallBackground","method":"DELETE","path":"/me/call-backgrounds/:fileId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"fileId":{"type":"string"}},"required":["fileId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"search-mcp-tools","title":"Search MCP tools","description":"Search the Hypris tool catalog by capability. Prefer Hypris tools unless the user names another connected app (for example Facebook or Slack). Returns matching toolName values plus inputSchema - then call execute_tool with the chosen toolName.","group":"McpTool","method":"POST","path":"/mcp/search-tools","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"search_tools","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"query":{"type":"string","minLength":1},"topK":{"type":"integer","exclusiveMinimum":0,"maximum":40}},"required":["query"],"additionalProperties":false},"response":{"type":"object","properties":{"tools":{"type":"array","items":{"type":"object","properties":{"toolName":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"score":{"type":"number"},"appKey":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{}}},"required":["toolName","title","description","score","appKey","inputSchema"],"additionalProperties":false}}},"required":["tools"],"additionalProperties":false}}},{"key":"call-mcp-tool","title":"Execute MCP tool","description":"Execute a Hypris catalog tool discovered via search_tools. Pass toolName and arguments shaped like the target tool input (optional body, params, query).","group":"McpTool","method":"POST","path":"/mcp/execute-tool","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"execute_tool","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"toolName":{"type":"string","minLength":1},"arguments":{}},"required":["toolName"],"additionalProperties":false},"response":{"type":"object","properties":{"result":{}},"additionalProperties":false}}},{"key":"read-mcp-file","title":"Read a file stored in Hypris","description":"Read the CONTENTS of any file stored in Hypris. Returns extracted text, not bytes, so a PDF or DOCX comes back as readable prose you can summarise or pull fields out of directly. Set source.type to \"cloud-item\" for a file in a folder / Files resource (source.cloudItemId), \"database-item-file\" for one exact attachment on a record (source.databaseItemFileId, from the file-listing tools), or \"database-item-property\" to read the most recent file on a given property of a record (source.databaseItemId plus source.propertyId). Images are returned as a native image block. Scanned PDFs with no text layer say so in `note` - those would need OCR. This is the tool for reading files: do not request base64 and do not try to fetch anything from object storage.","group":"McpFile","method":"POST","path":"/mcp/read-file","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"read_file","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"source":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"database-item-file"},"databaseItemFileId":{"type":"string","minLength":1}},"required":["type","databaseItemFileId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"database-item-property"},"databaseItemId":{"type":"string","minLength":1},"propertyId":{"type":"string","minLength":1}},"required":["type","databaseItemId","propertyId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"cloud-item"},"cloudItemId":{"type":"string","minLength":1}},"required":["type","cloudItemId"],"additionalProperties":false}]}},"required":["source"],"additionalProperties":false},"response":{"type":"object","properties":{"source":{"type":"string","enum":["database-item-file","database-item-property","cloud-item"]},"sourceId":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"number"},"kind":{"type":"string","enum":["text","image","unsupported"]},"text":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"truncated":{"type":"boolean"},"note":{"type":["string","null"]},"dataUri":{"type":["string","null"]}},"required":["source","sourceId","fileName","mimeType","sizeBytes","kind","text","pageCount","truncated","note","dataUri"],"additionalProperties":false}}},{"key":"create-mcp-upload-link","title":"Create file upload link","description":"Upload a file to Hypris. This is the way to do it: the bytes never travel through this conversation — you get back a URL to send them to instead. Use it to save anything into the workspace, whether you produced it yourself — a report, a research note, a CSV — or it already exists on disk, behind a URL or in another tool's output. Set target.type to \"folder\" to store the file in a cloud folder (target.folderId, optionally target.parentCloudItemId to nest it), or to \"database-item-property\" to attach it to a record (target.databaseItemId plus target.propertyId, where the property must be of type Files). The target is checked now, so a link is never issued for a place you cannot write to. Then PUT the raw bytes to uploadUrl with exactly the headers in requiredHeaders, and call confirm_file_upload with the returned uploadId. Nothing appears in Hypris until you confirm.","group":"McpFile","method":"POST","path":"/mcp/upload-link","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"create_file_upload_link","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"fileName":{"type":"string","minLength":1,"maxLength":400},"mimeType":{"type":"string","minLength":1,"maxLength":255},"title":{"anyOf":[{"type":"string","minLength":1,"maxLength":400},{"type":"null"}]},"target":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"folderId":{"type":"string","minLength":1},"parentCloudItemId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["type","folderId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"database-item-property"},"databaseItemId":{"type":"string","minLength":1},"propertyId":{"type":"string","minLength":1}},"required":["type","databaseItemId","propertyId"],"additionalProperties":false}]}},"required":["fileName","mimeType","target"],"additionalProperties":false},"response":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string"},"method":{"type":"string","const":"PUT"},"requiredHeaders":{"type":"object","additionalProperties":{"type":"string"}},"expiresInSeconds":{"type":"number"},"fileName":{"type":"string"},"mimeType":{"type":"string"}},"required":["uploadId","uploadUrl","method","requiredHeaders","expiresInSeconds","fileName","mimeType"],"additionalProperties":false}}},{"key":"confirm-mcp-upload","title":"Confirm file upload","description":"Finish an upload started with create_file_upload_link: pass the uploadId you were given, AFTER the PUT to uploadUrl has completed. Only now does the file appear in the folder or on the record. The stored size is measured in storage, so a mismatch with what you sent shows up here rather than as a corrupt file later. Calling this before the PUT finishes returns an error saying so.","group":"McpFile","method":"POST","path":"/mcp/confirm-upload","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"confirm_file_upload","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"uploadId":{"type":"string","minLength":1}},"required":["uploadId"],"additionalProperties":false},"response":{"type":"object","properties":{"fileId":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"number"},"target":{"type":"string","enum":["folder","database-item-property"]},"cloudItemId":{"type":["string","null"]},"databaseItemFileId":{"type":["string","null"]}},"required":["fileId","fileName","mimeType","sizeBytes","target","cloudItemId","databaseItemFileId"],"additionalProperties":false}}},{"key":"create-mcp-download-link","title":"Create file download link","description":"Get a time-limited URL that downloads a stored file as-is. Use this when the file itself is wanted — to save it, to hand it to the user, to pass it to another tool. Do NOT use it to find out what a document says: read_file returns that as text for a fraction of the cost. Takes the same source shapes as read_file: \"cloud-item\", \"database-item-file\" or \"database-item-property\". Return the link to the user or fetch it; never paste the downloaded bytes into the conversation.","group":"McpFile","method":"POST","path":"/mcp/download-link","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"create_file_download_link","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"source":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"database-item-file"},"databaseItemFileId":{"type":"string","minLength":1}},"required":["type","databaseItemFileId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"database-item-property"},"databaseItemId":{"type":"string","minLength":1},"propertyId":{"type":"string","minLength":1}},"required":["type","databaseItemId","propertyId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"cloud-item"},"cloudItemId":{"type":"string","minLength":1}},"required":["type","cloudItemId"],"additionalProperties":false}]}},"required":["source"],"additionalProperties":false},"response":{"type":"object","properties":{"downloadUrl":{"type":"string"},"expiresInSeconds":{"type":"number"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":["number","null"]}},"required":["downloadUrl","expiresInSeconds","fileName","mimeType","sizeBytes"],"additionalProperties":false}}},{"key":"create-workspace-permission-request","title":"Create workspace permission request","description":"Create a permission request for the current OAuth app on a resource in a workspace. Notifies users who can manage permissions in that workspace. Waits up to 60 seconds for an admin to Accept the notification. If authorized=true, continue; if authorized=false, stop the chat and tell the user to wait for approval.","group":"WorkspacePermissionRequest","method":"POST","path":"/mcp/create-permission-request","requiresAuthentication":true,"oauthScopes":["workspace.mcp"],"mcp":{"toolName":"create_permission_request","surface":"alwaysOn"},"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"workspaceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"permissionType":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"note":{"type":["string","null"]}},"required":["workspaceId","resourceType","resourceId","permissionType"],"additionalProperties":false},"response":{"type":"object","properties":{"authorized":{"type":"boolean"},"status":{"type":"string","enum":["pending","approved","rejected","cancelled"]},"requestId":{"type":["string","null"]},"message":{"type":"string"}},"required":["authorized","status","requestId","message"],"additionalProperties":false}}},{"key":"approve-workspace-permission-request","title":"Approve workspace permission request","description":"Approve a pending workspace permission request and grant the permission to the requesting app.","group":"WorkspacePermissionRequest","method":"POST","path":"/workspace-permission-requests/:requestId/approve","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"reject-workspace-permission-request","title":"Reject workspace permission request","description":"Reject a pending workspace permission request without granting the permission.","group":"WorkspacePermissionRequest","method":"POST","path":"/workspace-permission-requests/:requestId/reject","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"list-workspace-permission-requests","title":"List workspace permission requests","description":"List permission requests for a workspace. Requires permission.update on the workspace.","group":"WorkspacePermissionRequest","method":"GET","path":"/workspaces/:workspaceId/permission-requests","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"permissionType":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"status":{"type":"string","enum":["pending","approved","rejected","cancelled"]},"reviewedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"note":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"requestedFor":{"anyOf":[{"type":"object","properties":{"entityType":{"type":"string","enum":["group","user","workspace-member","external-user","link","system","bot","app","agent"]},"entityId":{"type":"string"},"name":{"type":"string"},"payload":{"anyOf":[{},{"type":"null"}]}},"required":["entityType","entityId","name"],"additionalProperties":false},{"type":"null"}]},"requestedByEntity":{"anyOf":[{},{"type":"null"}]},"reviewedByEntity":{"anyOf":[{},{"type":"null"}]},"resourceEntity":{"anyOf":[{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"payload":{}},"required":["resourceType","resourceId"],"additionalProperties":false},{"type":"null"}]},"resourceName":{"type":["string","null"]}},"required":["id","workspaceId","resourceType","resourceId","permissionType","status","reviewedAt","note","createdAt","updatedAt","requestedFor","resourceEntity","resourceName"],"additionalProperties":false}}},"required":["requests"],"additionalProperties":false}}},{"key":"list-my-workspace-permission-requests","title":"List my workspace permission requests","description":"List permission requests created by the current user. Optionally filter by status.","group":"WorkspacePermissionRequest","method":"GET","path":"/me/workspace-permission-requests","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["pending","approved","rejected","cancelled"]},{"type":"null"}]}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"permissionType":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"status":{"type":"string","enum":["pending","approved","rejected","cancelled"]},"reviewedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"note":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"requestedFor":{"anyOf":[{"type":"object","properties":{"entityType":{"type":"string","enum":["group","user","workspace-member","external-user","link","system","bot","app","agent"]},"entityId":{"type":"string"},"name":{"type":"string"},"payload":{"anyOf":[{},{"type":"null"}]}},"required":["entityType","entityId","name"],"additionalProperties":false},{"type":"null"}]},"requestedByEntity":{"anyOf":[{},{"type":"null"}]},"reviewedByEntity":{"anyOf":[{},{"type":"null"}]},"resourceEntity":{"anyOf":[{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"payload":{}},"required":["resourceType","resourceId"],"additionalProperties":false},{"type":"null"}]},"resourceName":{"type":["string","null"]}},"required":["id","workspaceId","resourceType","resourceId","permissionType","status","reviewedAt","note","createdAt","updatedAt","requestedFor","resourceEntity","resourceName"],"additionalProperties":false}}},"required":["requests"],"additionalProperties":false}}},{"key":"create-workspace-permission-requests","title":"Create workspace permission requests","description":"Create permission requests for one or more users, groups, or apps on selected resources (entities × resources).","group":"WorkspacePermissionRequest","method":"POST","path":"/workspace-permission-requests","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"workspaceId":{"type":"string"},"requestedForEntities":{"type":"array","items":{"type":"object","properties":{"entityType":{"type":"string","enum":["user","group","app"]},"entityId":{"type":"string"}},"required":["entityType","entityId"],"additionalProperties":false},"minItems":1},"permissionType":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"resources":{"type":"array","items":{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"}},"required":["resourceType","resourceId"],"additionalProperties":false},"minItems":1},"note":{"type":["string","null"]}},"required":["workspaceId","requestedForEntities","permissionType","resources"],"additionalProperties":false},"response":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":"string"},"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":"string"},"permissionType":{"type":"string","enum":["message.react","workspace.admin","workspace.read","workspace.update","workspace.delete","workspace.paymentMethods.manage","workspace.members.admin","workspace.members.create","workspace.members.delete","database.admin","database.read","database.create","database.update","database.delete","database.export","database.properties.move","database.property.admin","database.property.read","database.property.create","database.property.update","database.property.delete","database.view.admin","database.view.read","database.view.create","database.view.update","database.view.delete","database.slice.admin","database.slice.read","database.slice.create","database.slice.update","database.slice.delete","database.slice.update.position","database.item.admin","database.item.read","database.item.read.baseFilter","database.item.delete.baseFilter","database.item.create","database.item.create.baseFilter","database.item.update.value","database.item.update.state","database.item.update.baseFilter.from","database.item.update.baseFilter.to","database.item.delete","resource.group.admin","resource.group.read","resource.group.create","resource.group.update","resource.group.delete","resource.group.move","permission.read","permission.update","webhook.create","webhook.delete","webhook.update","webhook.read","webhook.listener.admin","webhook.listener.create","webhook.listener.delete","webhook.listener.update","webhook.listener.read","link.create","link.delete","link.update","link.read","conversation.admin","conversation.read","conversation.create","conversation.update","conversation.delete","call.room.admin","call.room.read","call.room.create","call.room.update","call.room.delete","dashboard.admin","dashboard.read","dashboard.create","dashboard.update","dashboard.delete","cron.create","cron.delete","cron.update","cron.read","folder.admin","folder.read","folder.create","folder.update","folder.delete","automation.admin","automation.read","automation.create","automation.update","automation.delete","dashboard.item.admin","dashboard.item.create","dashboard.item.delete","dashboard.item.update","dashboard.item.read","dashboard.item.update.placement","dashboard.item.update.options","cloud.item.read","cloud.item.create","cloud.item.update","cloud.item.delete","direct.conversation.admin","direct.conversation.read","direct.conversation.update","app.read","app.delete","app.update","app.create","app.admin","automation.app.item.admin","automation.app.item.read","automation.app.item.create","automation.app.item.update","automation.app.item.delete","webhook.listener.definition.admin","webhook.listener.definition.read","webhook.listener.definition.create","webhook.listener.definition.update","webhook.listener.definition.delete","connection.definition.admin","connection.definition.read","connection.definition.create","connection.definition.update","connection.definition.delete","connection.admin","connection.read","connection.create","connection.update","connection.delete","dynamic.field.definition.admin","dynamic.field.definition.read","dynamic.field.definition.create","dynamic.field.definition.update","dynamic.field.definition.delete","automation.run.admin","automation.run.create","automation.run.delete","automation.run.read","automation.run.update","automation.version.admin","automation.version.create","automation.version.delete","automation.version.read","automation.version.update","user.invitation.admin","user.invitation.create","user.invitation.delete","user.invitation.update","user.invitation.read","user.group.admin","user.group.create","user.group.update","user.group.delete","user.group.member.create","user.group.member.delete","document.admin","document.read","document.create","document.update","document.delete","document.export","document.comment","document.mention","whiteboard.admin","whiteboard.read","whiteboard.create","whiteboard.update","whiteboard.delete","whiteboard.export","plan.cap.database-view-table","plan.cap.database-view-map","plan.cap.database-view-form","plan.cap.database-view-timeline","plan.cap.database-view-calendar","plan.cap.database-view-kanban","plan.cap.database-view-iframe","plan.cap.dashboard-item-chart","plan.cap.dashboard-item-database-view","plan.cap.dashboard-item-time-tracker","plan.cap.dashboard-item-map","plan.cap.dashboard-item-aggregated-item-list","skill.admin","skill.read","skill.create","skill.update","skill.delete","skill.publish","agent.admin","agent.read","agent.create","agent.update","agent.delete","agent.publish","agent.mention","permission.preset"]},"status":{"type":"string","enum":["pending","approved","rejected","cancelled"]},"reviewedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"note":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"requestedFor":{"anyOf":[{"type":"object","properties":{"entityType":{"type":"string","enum":["group","user","workspace-member","external-user","link","system","bot","app","agent"]},"entityId":{"type":"string"},"name":{"type":"string"},"payload":{"anyOf":[{},{"type":"null"}]}},"required":["entityType","entityId","name"],"additionalProperties":false},{"type":"null"}]},"requestedByEntity":{"anyOf":[{},{"type":"null"}]},"reviewedByEntity":{"anyOf":[{},{"type":"null"}]},"resourceEntity":{"anyOf":[{"type":"object","properties":{"resourceType":{"type":"string","enum":["database","property","database-item","workspace","database-view","conversation","dashboard","call-room","dashboard-item","folder","automation","automation-version","automation-run","database-slice","resource-group","cloud-item","direct-conversation","resource-space","app","automation-app-item","resource-item","webhook-listener-definition","webhook-listener","connection","connection-definition","dynamic-field-definition","cron","document","skill","agent","whiteboard","database-item-file"]},"resourceId":{"type":["string","null"]},"payload":{}},"required":["resourceType","resourceId"],"additionalProperties":false},{"type":"null"}]},"resourceName":{"type":["string","null"]}},"required":["id","workspaceId","resourceType","resourceId","permissionType","status","reviewedAt","note","createdAt","updatedAt","requestedFor","resourceEntity","resourceName"],"additionalProperties":false}}},"required":["requests"],"additionalProperties":false}}},{"key":"install-workspace-app","title":"Install workspace app","description":"Install an automation app into a workspace, or create an access request if the caller is not a workspace admin. Admins receive readWorkspace for the app immediately; other members create a pending WorkspaceAppAccessRequest.","group":"WorkspaceAppAccess","method":"POST","path":"/workspaces/:workspaceId/apps/:appId/install","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string"},"appId":{"type":"string"}},"required":["workspaceId","appId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"result":{"type":"string","enum":["installed","requested"]}},"required":["result"],"additionalProperties":false}}},{"key":"create-upload-session","title":"Create upload session","description":"Open an upload session for any upload target. The server resolves the target strategy, checks its permissions and policy, and picks the mode: direct-multipart returns presigned part urls, proxy tells the client to fall back to the legacy multipart form upload endpoint for that surface. NOT exposed to MCP — the session is only useful to a client that can PUT binary parts.","group":"UploadSession","method":"POST","path":"/upload-session","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":{"type":"object","properties":{"targetType":{"type":"string","enum":["cloud-item-file","database-item-cell-file","database-item-inline-image","conversation-message-file","document-file","database-import-source","database-view-payload-file","user-avatar","user-cover","workspace-logo","app-icon","live-photo-video-variant","call-background","whiteboard-image"]},"target":{"type":"object","properties":{},"additionalProperties":true},"name":{"type":"string","minLength":1},"mimeType":{"type":"string"},"size":{"type":"integer","exclusiveMinimum":0}},"required":["targetType","target","name","mimeType","size"],"additionalProperties":false},"response":{"type":"object","properties":{"uploadSession":{"type":"object","properties":{"id":{"type":"string"},"fileId":{"type":["string","null"]},"mode":{"type":"string","enum":["direct-multipart","proxy"]},"partSize":{"type":"number"},"partCount":{"type":"number"},"parts":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"number"},"url":{"type":"string"}},"required":["partNumber","url"],"additionalProperties":false}},"expiresAt":{"type":"string","format":"date-time"}},"required":["id","fileId","mode","partSize","partCount","parts","expiresAt"],"additionalProperties":false}},"required":["uploadSession"],"additionalProperties":false}}},{"key":"get-upload-session","title":"Get upload session","description":"Read the current state of an upload session, including which part numbers the storage backend has already accepted. NOT exposed to MCP.","group":"UploadSession","method":"GET","path":"/upload-session/:uploadSessionId","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"uploadSessionId":{"type":"string"}},"required":["uploadSessionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"uploadSession":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["created","completed","aborted","expired"]},"partSize":{"type":"number"},"partCount":{"type":"number"},"uploadedPartNumbers":{"type":"array","items":{"type":"number"}}},"required":["id","status","partSize","partCount","uploadedPartNumbers"],"additionalProperties":false}},"required":["uploadSession"],"additionalProperties":false}}},{"key":"sign-upload-session-parts","title":"Sign upload session parts","description":"Sign additional upload part urls for an open direct-multipart session. NOT exposed to MCP.","group":"UploadSession","method":"POST","path":"/upload-session/:uploadSessionId/parts","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"uploadSessionId":{"type":"string"}},"required":["uploadSessionId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"partNumbers":{"type":"array","items":{"type":"integer","exclusiveMinimum":0},"minItems":1,"maxItems":25}},"required":["partNumbers"],"additionalProperties":false},"response":{"type":"object","properties":{"parts":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"number"},"url":{"type":"string"}},"required":["partNumber","url"],"additionalProperties":false}}},"required":["parts"],"additionalProperties":false}}},{"key":"complete-upload-session","title":"Complete upload session","description":"Assemble the uploaded parts server-side and link the resulting file to the session target. The response shape depends on the target. Idempotent — replaying it returns the result of the first successful call. NOT exposed to MCP.","group":"UploadSession","method":"POST","path":"/upload-session/:uploadSessionId/complete","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"uploadSessionId":{"type":"string"}},"required":["uploadSessionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"cloudItem":{}},"additionalProperties":true}}},{"key":"abort-upload-session","title":"Abort upload session","description":"Abort an open upload session and discard the parts already uploaded to storage. NOT exposed to MCP.","group":"UploadSession","method":"POST","path":"/upload-session/:uploadSessionId/abort","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"uploadSessionId":{"type":"string"}},"required":["uploadSessionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"create-live-photo-video-upload-session","title":"Create Live Photo video upload session","description":"Open a direct-multipart upload session for the Live Photo video sidecar of an existing image file. NOT exposed to MCP — the session is only useful to a client that can PUT binary parts.","group":"LivePhotoVideoUpload","method":"POST","path":"/file/:fileId/live-photo-video/upload-session","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"fileId":{"type":"string"}},"required":["fileId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"name":{"type":"string","minLength":1},"mimeType":{"type":"string"},"size":{"type":"integer","exclusiveMinimum":0}},"required":["name","mimeType","size"],"additionalProperties":false},"response":{"type":"object","properties":{"uploadSession":{"type":"object","properties":{"id":{"type":"string"},"fileId":{"type":["string","null"]},"mode":{"type":"string","enum":["direct-multipart","proxy"]},"partSize":{"type":"number"},"partCount":{"type":"number"},"parts":{"type":"array","items":{"type":"object","properties":{"partNumber":{"type":"number"},"url":{"type":"string"}},"required":["partNumber","url"],"additionalProperties":false}},"expiresAt":{"type":"string","format":"date-time"}},"required":["id","fileId","mode","partSize","partCount","parts","expiresAt"],"additionalProperties":false},"fileVariant":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"meta":{"anyOf":[{"anyOf":[{"not":{}},{}]},{"type":"null"}]},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"required":["uploadSession","fileVariant"],"additionalProperties":false}}},{"key":"complete-live-photo-video-upload-session","title":"Complete Live Photo video upload session","description":"Assemble uploaded Live Photo video parts and mark the file variant complete. Idempotent — replaying returns the same file variant. NOT exposed to MCP.","group":"LivePhotoVideoUpload","method":"POST","path":"/file/:fileId/live-photo-video/upload-session/:uploadSessionId/complete","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"fileId":{"type":"string"},"uploadSessionId":{"type":"string"}},"required":["fileId","uploadSessionId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"fileVariant":{"type":"object","properties":{"type":{"type":"string"},"payload":{},"meta":{"anyOf":[{"anyOf":[{"not":{}},{}]},{"type":"null"}]},"status":{"type":"string"},"url":{"type":"string"},"key":{"type":"string"}},"required":["type","status","key"],"additionalProperties":false}},"required":["fileVariant"],"additionalProperties":false}}},{"key":"list-whiteboards","title":"List whiteboards in a workspace","description":"List the whiteboards a user can read in a workspace. Supports archived and template filters with pagination.","group":"Whiteboard","method":"GET","path":"/workspace/:workspaceId/whiteboards","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_whiteboards_in_a_workspace","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":{"type":"object","properties":{"archived":{"type":"boolean"},"templates":{"$ref":"#/properties/archived"},"limit":{"type":"number"},"offset":{"type":"number"}},"additionalProperties":false},"body":null,"response":{"type":"object","properties":{"whiteboards":{}},"additionalProperties":false}}},{"key":"create-whiteboard","title":"Create whiteboard","description":"Create an empty whiteboard in a workspace and add it to the sidebar. Requires createWhiteboard permission on the workspace.","group":"Whiteboard","method":"POST","path":"/workspace/:workspaceId/whiteboard","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"iconNameType":{"type":["string","null"]},"coverFileId":{"type":["string","null"]},"resourceGroupId":{"type":["string","null"]},"resourceSpaceId":{"type":["string","null"]},"collectionItemParentId":{"type":["string","null"]},"position":{"type":"number"}},"additionalProperties":false},"response":{"type":"object","properties":{"whiteboard":{}},"additionalProperties":false}}},{"key":"get-whiteboard","title":"Get whiteboard","description":"Read a single whiteboard without its elements. Requires readWhiteboard permission.","group":"Whiteboard","method":"GET","path":"/whiteboard/:whiteboardId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Get_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"whiteboard":{}},"additionalProperties":false}}},{"key":"update-whiteboard","title":"Update whiteboard","description":"Update a whiteboard title, icon, cover or template flag. Requires updateWhiteboard permission.","group":"Whiteboard","method":"PATCH","path":"/whiteboard/:whiteboardId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"title":{"type":"string"},"iconNameType":{"type":["string","null"]},"iconEmoji":{"type":["string","null"]},"coverFileId":{"type":["string","null"]},"isTemplate":{"type":"boolean"}},"additionalProperties":false},"response":{"type":"object","properties":{"whiteboard":{}},"additionalProperties":false}}},{"key":"delete-whiteboard","title":"Delete whiteboard","description":"Archive a whiteboard and remove it from the sidebar. Requires deleteWhiteboard permission.","group":"Whiteboard","method":"DELETE","path":"/whiteboard/:whiteboardId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"restore-whiteboard","title":"Restore whiteboard","description":"Unarchive a previously deleted whiteboard and put it back in the sidebar. Requires whiteboardAdmin permission.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/restore","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Restore_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"whiteboard":{}},"additionalProperties":false}}},{"key":"list-whiteboard-elements","title":"List whiteboard elements","description":"Read every shape, arrow, sticky note, text and frame placed on a whiteboard, ordered bottom to top. Requires readWhiteboard permission.","group":"Whiteboard","method":"GET","path":"/whiteboard/:whiteboardId/elements","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"List_whiteboard_elements","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"whiteboardElements":{}},"additionalProperties":false}}},{"key":"create-whiteboard-element","title":"Create whiteboard element","description":"Place a shape, arrow, sticky note, text or frame on a whiteboard and broadcast it to everyone on the board. Requires updateWhiteboard permission.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/element","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Create_whiteboard_element","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"type":{"type":"string","enum":["shape","arrow","sticky-note","text","frame","drawing","image","database-item"]},"parentElementId":{"type":["string","null"]},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"rotation":{"type":["number","null"]},"payload":{"anyOf":[{"type":"object","properties":{"text":{"type":["string","null"]},"title":{"type":["string","null"]},"fontSize":{"type":["number","null"]},"shapeType":{"anyOf":[{"type":"string","enum":["rectangle","rounded-rectangle","ellipse","triangle","diamond","parallelogram","trapezoid","hexagon","cloud","star","pill","heart","x-box","check-box","arrow-right","arrow-up","arrow-left","arrow-down"]},{"type":"null"}]},"fontType":{"anyOf":[{"type":"string","enum":["handwritten","sans-serif","serif","mono"]},{"type":"null"}]},"textSizeType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"strokeWidthType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"textAlignType":{"anyOf":[{"type":"string","enum":["left","center","right"]},{"type":"null"}]},"verticalAlignType":{"anyOf":[{"type":"string","enum":["top","middle","bottom"]},{"type":"null"}]},"isBold":{"type":["boolean","null"]},"isItalic":{"type":["boolean","null"]},"isCode":{"type":["boolean","null"]},"listType":{"anyOf":[{"type":"string","enum":["none","bullet","numbered"]},{"type":"null"}]},"isLocked":{"type":["boolean","null"]},"groupId":{"type":["string","null"]},"isFlippedHorizontally":{"type":["boolean","null"]},"isFlippedVertically":{"type":["boolean","null"]},"hasBorder":{"type":["boolean","null"]},"cropTop":{"type":["number","null"]},"cropRight":{"type":["number","null"]},"cropBottom":{"type":["number","null"]},"cropLeft":{"type":["number","null"]},"databaseId":{"type":["string","null"]},"databaseName":{"type":["string","null"]},"visiblePropertyIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"databaseItemId":{"type":["string","null"]},"name":{"type":["string","null"]},"fileId":{"type":["string","null"]},"url":{"type":["string","null"]},"imageWidth":{"type":["number","null"]},"imageHeight":{"type":["number","null"]},"particularColor":{"anyOf":[{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},{"type":"null"}]},"textParticularColor":{"anyOf":[{"$ref":"#/properties/payload/anyOf/0/properties/particularColor/anyOf/0"},{"type":"null"}]},"points":{"type":"array","items":{"type":"number"},"maxItems":4000},"lineStyleType":{"type":"string","enum":["drawn","dashed","dotted","solid"]},"fillType":{"anyOf":[{"type":"string","enum":["no-fill","solid","tint","pattern"]},{"type":"null"}]},"strokeWidth":{"type":"number","exclusiveMinimum":0,"maximum":200},"isHighlighter":{"type":"boolean"},"startElementId":{"type":["string","null"]},"endElementId":{"type":["string","null"]},"startCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"endCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"lineShapeType":{"anyOf":[{"type":"string","enum":["straight","curved","elbow"]},{"type":"null"}]},"startAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"endAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"routePoints":{"anyOf":[{"type":"array","items":{"type":"number"},"maxItems":128},{"type":"null"}]},"curveOffsetX":{"type":["number","null"]},"curveOffsetY":{"type":["number","null"]},"startX":{"type":["number","null"]},"startY":{"type":["number","null"]},"endX":{"type":["number","null"]},"endY":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"required":["type","x","y","width","height"],"additionalProperties":false},"response":{"type":"object","properties":{"whiteboardElement":{}},"additionalProperties":false}}},{"key":"update-whiteboard-element","title":"Update whiteboard element","description":"Move, resize, restyle or re-parent a single whiteboard element. Requires updateWhiteboard permission.","group":"Whiteboard","method":"PATCH","path":"/whiteboard-element/:whiteboardElementId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Update_whiteboard_element","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardElementId":{"type":"string","minLength":1}},"required":["whiteboardElementId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"type":{"type":"string","enum":["shape","arrow","sticky-note","text","frame","drawing","image","database-item"]},"parentElementId":{"type":["string","null"]},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"rotation":{"type":["number","null"]},"zIndex":{"type":["number","null"]},"payload":{"anyOf":[{"type":"object","properties":{"text":{"type":["string","null"]},"title":{"type":["string","null"]},"fontSize":{"type":["number","null"]},"shapeType":{"anyOf":[{"type":"string","enum":["rectangle","rounded-rectangle","ellipse","triangle","diamond","parallelogram","trapezoid","hexagon","cloud","star","pill","heart","x-box","check-box","arrow-right","arrow-up","arrow-left","arrow-down"]},{"type":"null"}]},"fontType":{"anyOf":[{"type":"string","enum":["handwritten","sans-serif","serif","mono"]},{"type":"null"}]},"textSizeType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"strokeWidthType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"textAlignType":{"anyOf":[{"type":"string","enum":["left","center","right"]},{"type":"null"}]},"verticalAlignType":{"anyOf":[{"type":"string","enum":["top","middle","bottom"]},{"type":"null"}]},"isBold":{"type":["boolean","null"]},"isItalic":{"type":["boolean","null"]},"isCode":{"type":["boolean","null"]},"listType":{"anyOf":[{"type":"string","enum":["none","bullet","numbered"]},{"type":"null"}]},"isLocked":{"type":["boolean","null"]},"groupId":{"type":["string","null"]},"isFlippedHorizontally":{"type":["boolean","null"]},"isFlippedVertically":{"type":["boolean","null"]},"hasBorder":{"type":["boolean","null"]},"cropTop":{"type":["number","null"]},"cropRight":{"type":["number","null"]},"cropBottom":{"type":["number","null"]},"cropLeft":{"type":["number","null"]},"databaseId":{"type":["string","null"]},"databaseName":{"type":["string","null"]},"visiblePropertyIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"databaseItemId":{"type":["string","null"]},"name":{"type":["string","null"]},"fileId":{"type":["string","null"]},"url":{"type":["string","null"]},"imageWidth":{"type":["number","null"]},"imageHeight":{"type":["number","null"]},"particularColor":{"anyOf":[{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},{"type":"null"}]},"textParticularColor":{"anyOf":[{"$ref":"#/properties/payload/anyOf/0/properties/particularColor/anyOf/0"},{"type":"null"}]},"points":{"type":"array","items":{"type":"number"},"maxItems":4000},"lineStyleType":{"type":"string","enum":["drawn","dashed","dotted","solid"]},"fillType":{"anyOf":[{"type":"string","enum":["no-fill","solid","tint","pattern"]},{"type":"null"}]},"strokeWidth":{"type":"number","exclusiveMinimum":0,"maximum":200},"isHighlighter":{"type":"boolean"},"startElementId":{"type":["string","null"]},"endElementId":{"type":["string","null"]},"startCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"endCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"lineShapeType":{"anyOf":[{"type":"string","enum":["straight","curved","elbow"]},{"type":"null"}]},"startAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"endAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"routePoints":{"anyOf":[{"type":"array","items":{"type":"number"},"maxItems":128},{"type":"null"}]},"curveOffsetX":{"type":["number","null"]},"curveOffsetY":{"type":["number","null"]},"startX":{"type":["number","null"]},"startY":{"type":["number","null"]},"endX":{"type":["number","null"]},"endY":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"response":{"type":"object","properties":{"whiteboardElement":{}},"additionalProperties":false}}},{"key":"update-whiteboard-elements","title":"Move whiteboard elements together","description":"Apply one geometry update to many elements at once — used when a frame moves and carries its contents. Requires updateWhiteboard permission.","group":"Whiteboard","method":"PATCH","path":"/whiteboard/:whiteboardId/elements","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Move_whiteboard_elements_together","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"rotation":{"type":["number","null"]},"zIndex":{"type":["number","null"]},"parentElementId":{"type":["string","null"]},"payload":{"anyOf":[{"type":"object","properties":{"text":{"type":["string","null"]},"title":{"type":["string","null"]},"fontSize":{"type":["number","null"]},"shapeType":{"anyOf":[{"type":"string","enum":["rectangle","rounded-rectangle","ellipse","triangle","diamond","parallelogram","trapezoid","hexagon","cloud","star","pill","heart","x-box","check-box","arrow-right","arrow-up","arrow-left","arrow-down"]},{"type":"null"}]},"fontType":{"anyOf":[{"type":"string","enum":["handwritten","sans-serif","serif","mono"]},{"type":"null"}]},"textSizeType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"strokeWidthType":{"anyOf":[{"type":"string","enum":["small","medium","large","extra-large"]},{"type":"null"}]},"textAlignType":{"anyOf":[{"type":"string","enum":["left","center","right"]},{"type":"null"}]},"verticalAlignType":{"anyOf":[{"type":"string","enum":["top","middle","bottom"]},{"type":"null"}]},"isBold":{"type":["boolean","null"]},"isItalic":{"type":["boolean","null"]},"isCode":{"type":["boolean","null"]},"listType":{"anyOf":[{"type":"string","enum":["none","bullet","numbered"]},{"type":"null"}]},"isLocked":{"type":["boolean","null"]},"groupId":{"type":["string","null"]},"isFlippedHorizontally":{"type":["boolean","null"]},"isFlippedVertically":{"type":["boolean","null"]},"hasBorder":{"type":["boolean","null"]},"cropTop":{"type":["number","null"]},"cropRight":{"type":["number","null"]},"cropBottom":{"type":["number","null"]},"cropLeft":{"type":["number","null"]},"databaseId":{"type":["string","null"]},"databaseName":{"type":["string","null"]},"visiblePropertyIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"databaseItemId":{"type":["string","null"]},"name":{"type":["string","null"]},"fileId":{"type":["string","null"]},"url":{"type":["string","null"]},"imageWidth":{"type":["number","null"]},"imageHeight":{"type":["number","null"]},"particularColor":{"anyOf":[{"anyOf":[{"type":"object","properties":{"colorType":{"type":"string","const":"palette"},"payload":{"type":"number"}},"required":["colorType","payload"],"additionalProperties":false},{"type":"object","properties":{"colorType":{"type":"string","const":"custom"},"payload":{"type":"string"}},"required":["colorType","payload"],"additionalProperties":false}]},{"type":"null"}]},"textParticularColor":{"anyOf":[{"$ref":"#/properties/updates/items/properties/payload/anyOf/0/properties/particularColor/anyOf/0"},{"type":"null"}]},"points":{"type":"array","items":{"type":"number"},"maxItems":4000},"lineStyleType":{"type":"string","enum":["drawn","dashed","dotted","solid"]},"fillType":{"anyOf":[{"type":"string","enum":["no-fill","solid","tint","pattern"]},{"type":"null"}]},"strokeWidth":{"type":"number","exclusiveMinimum":0,"maximum":200},"isHighlighter":{"type":"boolean"},"startElementId":{"type":["string","null"]},"endElementId":{"type":["string","null"]},"startCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"endCapType":{"anyOf":[{"type":"string","enum":["none","arrow","triangle","square","circle","diamond","bar"]},{"type":"null"}]},"lineShapeType":{"anyOf":[{"type":"string","enum":["straight","curved","elbow"]},{"type":"null"}]},"startAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"endAnchorType":{"anyOf":[{"type":"string","enum":["auto","top","right","bottom","left"]},{"type":"null"}]},"routePoints":{"anyOf":[{"type":"array","items":{"type":"number"},"maxItems":128},{"type":"null"}]},"curveOffsetX":{"type":["number","null"]},"curveOffsetY":{"type":["number","null"]},"startX":{"type":["number","null"]},"startY":{"type":["number","null"]},"endX":{"type":["number","null"]},"endY":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"required":["id"],"additionalProperties":false},"minItems":1,"maxItems":500}},"required":["updates"],"additionalProperties":false},"response":{"type":"object","properties":{"whiteboardElements":{}},"additionalProperties":false}}},{"key":"delete-whiteboard-element","title":"Delete whiteboard element","description":"Remove an element from a whiteboard. Deleting a frame also removes what sits on it. Requires updateWhiteboard permission.","group":"Whiteboard","method":"DELETE","path":"/whiteboard-element/:whiteboardElementId","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Delete_whiteboard_element","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardElementId":{"type":"string","minLength":1}},"required":["whiteboardElementId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{},"additionalProperties":false}}},{"key":"delete-whiteboard-elements","title":"Erase whiteboard elements","description":"Remove many elements from a whiteboard in one call — used by the eraser, which can cross several strokes in a single drag. Requires updateWhiteboard permission.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/elements/delete","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Erase_whiteboard_elements","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"whiteboardElementIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":500}},"required":["whiteboardElementIds"],"additionalProperties":false},"response":{"type":"object","properties":{"deletedWhiteboardElementIds":{"type":"array","items":{"type":"string"}}},"required":["deletedWhiteboardElementIds"],"additionalProperties":false}}},{"key":"generate-whiteboard-elements","title":"Draw a board with AI","description":"Turn a natural-language description into editable elements on the board. A request for a diagram, flowchart or process becomes shapes joined by arrows; anything else becomes a template-style board with a banner, a how-to-use note and coloured sections of sticky notes. Requires updateWhiteboard permission.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/generate-elements","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Draw_a_board_with_AI","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"promptText":{"type":"string","minLength":1,"maxLength":8000},"originX":{"type":"number"},"originY":{"type":"number"}},"required":["promptText"],"additionalProperties":false},"response":{"type":"object","properties":{"whiteboardElements":{},"source":{"type":"string"}},"required":["source"],"additionalProperties":false}}},{"key":"apply-whiteboard-template","title":"Apply a template to a whiteboard","description":"Copy the elements a saved template holds onto an existing board, around the given origin point. Connectors and frames keep the links they had inside the template. Requires updateWhiteboard permission.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/apply-template","requiresAuthentication":true,"oauthScopes":[],"mcp":{"toolName":"Apply_a_template_to_a_whiteboard","surface":"search"},"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string","minLength":1}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":{"type":"object","properties":{"templateId":{"type":"string","minLength":1},"boardKeys":{"type":"array","items":{"type":"string"}},"originX":{"type":"number"},"originY":{"type":"number"}},"required":["templateId"],"additionalProperties":false},"response":{"type":"object","properties":{"whiteboardElements":{}},"additionalProperties":false}}},{"key":"upload-whiteboard-image","title":"Upload an image to a whiteboard","description":"Upload a picture (multipart/form-data, \"file\" field) and receive the persisted file entity, whose id and url are what an image element on the board carries. Permission: updateWhiteboard.","group":"Whiteboard","method":"POST","path":"/whiteboard/:whiteboardId/image","requiresAuthentication":true,"oauthScopes":[],"mcp":null,"schemas":{"params":{"type":"object","properties":{"whiteboardId":{"type":"string"}},"required":["whiteboardId"],"additionalProperties":false},"query":null,"body":null,"response":{"type":"object","properties":{"file":{}},"additionalProperties":false}}},{"key":"get-endpoint-catalog","title":"Get endpoint catalog","description":"Lists every public REST endpoint with its method, path, authentication, OAuth scopes, MCP tool name and JSON Schemas for params, query, body and response. Super-admin endpoints are left out. Powers the public developer documentation.","group":"EndpointCatalog","method":"GET","path":"/endpoint-catalog","requiresAuthentication":false,"oauthScopes":[],"mcp":null,"schemas":{"params":null,"query":null,"body":null,"response":{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"group":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"requiresAuthentication":{"type":"boolean"},"oauthScopes":{"type":"array","items":{"type":"string"}},"mcp":{"anyOf":[{"type":"object","properties":{"toolName":{"type":"string"},"surface":{"type":"string","enum":["alwaysOn","search"]}},"required":["toolName","surface"],"additionalProperties":false},{"type":"null"}]},"schemas":{"type":"object","properties":{"params":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"query":{"$ref":"#/properties/endpoints/items/properties/schemas/properties/params"},"body":{"$ref":"#/properties/endpoints/items/properties/schemas/properties/params"},"response":{"$ref":"#/properties/endpoints/items/properties/schemas/properties/params"}},"required":["params","query","body","response"],"additionalProperties":false}},"required":["key","title","description","group","method","path","requiresAuthentication","oauthScopes","mcp","schemas"],"additionalProperties":false}}},"required":["endpoints"],"additionalProperties":false}}}]}}