{"openapi":"3.1.0","info":{"title":"Blue REST API","version":"1.0.0","description":"REST API for Blue. Authenticate with a Personal Access Token (`Authorization: Bearer <token>`) and scope requests with the `blue-org-id` header (the legacy `x-bloo-company-id` is still accepted). Every operation is available as RPC (`POST /v1/<operation>`); core resources also have resource-style routes.\n\n**File uploads** use a presigned flow: `GET /uploads?filename=...` (same Bearer token, plus the `blue-workspace-id` header) returns `{ url, method: \"PUT\", headers, fields }`; PUT the binary to that URL, then finalize with `PUT /uploads/{uid}/confirm`. List uploaded files with `list-files`."},"servers":[{"url":"https://rest.blue.app/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/list-workspaces":{"post":{"operationId":"list-workspaces","summary":"List Workspaces","description":"List workspaces the user has access to. Call this first — most other tools require a workspaceId. Returns id, name, slug, description, and archived status.","tags":["workspace"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"search":{"description":"Filter by workspace name","type":"string"},"archived":{"description":"Filter by archived status (default: false)","type":"boolean"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"archived":{"type":"boolean"},"color":{"type":"string"},"icon":{"type":"string"},"category":{"type":"string","enum":["CRM","CROSS_FUNCTIONAL","CUSTOMER_SUCCESS","DESIGN","ENGINEERING","GENERAL","HR","IT","MARKETING","OPERATIONS","PRODUCT","SALES"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","uid","slug","name","category","createdAt","updatedAt"]}},"totalCount":{"type":"integer"}},"required":["items"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-workspace":{"post":{"operationId":"create-workspace","summary":"Create Workspace","description":"Create a new workspace in the company. Returns the new workspace ID for use with other tools.","tags":["workspace"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Workspace name"},"description":{"description":"Workspace description","type":"string"},"color":{"description":"Workspace color (hex code)","type":"string"},"icon":{"description":"Workspace icon","type":"string"},"category":{"description":"Workspace category","type":"string"}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"color":{"type":"string"},"icon":{"type":"string"},"category":{"type":"string","enum":["CRM","CROSS_FUNCTIONAL","CUSTOMER_SUCCESS","DESIGN","ENGINEERING","GENERAL","HR","IT","MARKETING","OPERATIONS","PRODUCT","SALES"]}},"required":["id","uid","slug","name","category"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-records":{"post":{"operationId":"list-records","summary":"List Records","description":"List records (tasks/items) with filtering and pagination. Can filter by workspace, list, status, assignees, or tags. Returns a summary view — use get-record for full details including checklists and custom fields.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"description":"Filter by workspace ID. If omitted, lists across all workspaces.","type":"string"},"listId":{"description":"Filter by list ID","type":"string"},"done":{"description":"Filter by completion status","type":"boolean"},"archived":{"description":"Filter by archived status","type":"boolean"},"assigneeIds":{"description":"Filter by assignee user IDs","type":"array","items":{"type":"string"}},"tagIds":{"description":"Filter by tag IDs","type":"array","items":{"type":"string"}},"search":{"description":"Search by title","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"archived":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]},"color":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"}},"required":["id","firstName","lastName","email"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}}},"required":["id","uid","title","done","archived","position","createdAt","updatedAt","list","users","tags"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"hasPreviousPage":{"type":"boolean"},"startCursor":{"type":"string"},"endCursor":{"type":"string"}},"required":["hasNextPage","hasPreviousPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-record":{"post":{"operationId":"get-record","summary":"Get Record","description":"Get full details of a single record by ID, including description, checklists, custom field values, tags, and assignees. Use list-records first to find record IDs.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"recordId":{"type":"string","description":"The record ID"}},"required":["workspaceId","recordId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"},"done":{"type":"boolean"},"archived":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]},"color":{"type":"string"},"cover":{"type":"string"},"commentCount":{"type":"integer"},"checklistCount":{"type":"integer"},"checklistCompletedCount":{"type":"integer"},"isRepeating":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"}},"required":["id","firstName","lastName","email"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}},"checklists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"checklistItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]}},"required":["id","title","done","position"]}}},"required":["id","title","position","checklistItems"]}},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["CHECKBOX","CURRENCY","EMAIL","LOCATION","NUMBER","PERCENT","PHONE","RATING","SELECT_MULTI","SELECT_SINGLE","TEXT_MULTI","TEXT_SINGLE","UNIQUE_ID","URL","FILE","COUNTRY","DATE","FORMULA","REFERENCE","LOOKUP","TIME_DURATION","BUTTON","CURRENCY_CONVERSION","ASSIGNEE","REFERENCED_BY","ROLLUP","TABLE"]},"text":{"type":"string"},"number":{"type":"number"},"checked":{"type":"boolean"},"customFieldOptions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}},"tableColumns":{},"tableRows":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"cells":{}},"required":["position","cells"]}},"tableTotals":{}},"required":["id","name","type"]}}},"required":["id","uid","title","text","html","done","archived","position","commentCount","checklistCount","checklistCompletedCount","isRepeating","createdAt","updatedAt","list","users","tags","checklists","customFields"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/count-records":{"post":{"operationId":"count-records","summary":"Count Records","description":"Count records matching a filter. Useful for dashboards or checking how many tasks are open/done in a workspace without fetching full data.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"description":"Filter by workspace ID","type":"string"},"done":{"description":"Filter by completion status","type":"boolean"},"archived":{"description":"Filter by archived status","type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-record":{"post":{"operationId":"create-record","summary":"Create Record","description":"Create a new record (task/item) in a workspace. Requires a workspaceId from list-workspaces. Optionally place it in a specific list (use list-lists to get list IDs), assign users, and apply tags.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID to create the record in"},"title":{"type":"string","description":"Record title"},"listId":{"description":"List ID to place the record in. If omitted, uses the first list.","type":"string"},"description":{"description":"Record description (plain text)","type":"string"},"startedAt":{"description":"Start date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"duedAt":{"description":"Due date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"allDay":{"description":"Force the dates to be all-day (a floating calendar date shown identically in every timezone) or timed. Usually unnecessary: bare YYYY-MM-DD dates are all-day automatically.","type":"boolean"},"assigneeIds":{"description":"User IDs to assign","type":"array","items":{"type":"string"}},"tagIds":{"description":"Tag IDs to apply","type":"array","items":{"type":"string"}}},"required":["workspaceId","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}},"required":["id","uid","title","position","list"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/update-record":{"post":{"operationId":"update-record","summary":"Update Record","description":"Update fields on an existing record. Only provide the fields you want to change — omitted fields are left unchanged. Use move-record instead to change which list a record is in.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID to update"},"title":{"description":"New title","type":"string"},"description":{"description":"New description (plain text)","type":"string"},"done":{"description":"Set the done status. Pass true to mark as done, false to mark as not done.","type":"boolean"},"startedAt":{"description":"Start date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"duedAt":{"description":"Due date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"allDay":{"description":"Force the dates to be all-day (a floating calendar date shown identically in every timezone) or timed. Usually unnecessary: bare YYYY-MM-DD dates are all-day automatically.","type":"boolean"},"color":{"description":"Record color","type":"string"},"assigneeIds":{"description":"User IDs to assign. Replaces all current assignees.","type":"array","items":{"type":"string"}}},"required":["workspaceId","recordId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/move-record":{"post":{"operationId":"move-record","summary":"Move Record","description":"Move a record to a different list (column/status). Use list-lists to get available list IDs for the workspace.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID to move"},"listId":{"type":"string","description":"The target list ID"}},"required":["workspaceId","recordId","listId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/delete-record":{"post":{"operationId":"delete-record","summary":"Delete Record","description":"Permanently delete a record. This cannot be undone. The record is moved to trash internally but removed from the workspace. Use get-record first to verify you are deleting the correct record.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID to delete"}},"required":["workspaceId","recordId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/search-records":{"post":{"operationId":"search-records","summary":"Search Records","description":"Full-text search for records by name/content within a workspace. This is the right tool to find records in large workspaces — it queries the backend directly rather than filtering a loaded page, so it finds matches list-records would never page to. Returns a summary view; use get-record for full detail.","tags":["record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace ID or slug to search within"},"query":{"type":"string","description":"Search text to match against record titles and content"},"done":{"description":"Filter by completion status","type":"boolean"},"archived":{"description":"Include archived records. Defaults to false (excludes archived).","type":"boolean"},"limit":{"description":"Maximum results, max 100 (default: 20)","type":"number"}},"required":["workspaceId","query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"archived":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}}},"required":["id","uid","title","done","archived","createdAt","updatedAt","list","users","tags"]}}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-lists":{"post":{"operationId":"list-lists","summary":"List Lists","description":"List all lists (columns/statuses) in a workspace. Lists represent workflow stages and contain records. Use this to get list IDs needed by create-record and move-record.","tags":["list"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"completed":{"type":"boolean"},"isLocked":{"type":"boolean"},"isDisabled":{"type":"boolean"},"todosCount":{"type":"integer"}},"required":["id","uid","title","position","isDisabled","todosCount"]}}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-list":{"post":{"operationId":"create-list","summary":"Create List","description":"Create a new list (column/status) in a workspace. Lists represent workflow stages that contain records. Use list-lists first to check existing lists and determine the position for the new one.","tags":["list"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"title":{"type":"string","description":"The title of the list"},"position":{"description":"Position of the list (determines order). If omitted, the list is appended at the end. Use list-lists to see existing positions.","type":"number"}},"required":["workspaceId","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"completed":{"type":"boolean"},"isLocked":{"type":"boolean"},"isDisabled":{"type":"boolean"}},"required":["id","uid","title","position","isDisabled"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-tags":{"post":{"operationId":"list-tags","summary":"List Tags","description":"List tags available in a workspace. Use this to get tag IDs needed by create-record and set-tags-on-record.","tags":["tag"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"search":{"description":"Filter by tag name","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","uid","title","color","createdAt"]}},"totalCount":{"type":"integer"}},"required":["items","totalCount"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-tag":{"post":{"operationId":"create-tag","summary":"Create Tag","description":"Create a new tag in a workspace. Returns the tag ID, which can then be applied to records via create-record or set-tags-on-record.","tags":["tag"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"title":{"type":"string","description":"Tag name"},"color":{"description":"Tag color (hex code)","type":"string"}},"required":["workspaceId","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","uid","title","color","createdAt"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/set-tags-on-record":{"post":{"operationId":"set-tags-on-record","summary":"Set Tags on Record","description":"Set tags on a record. This replaces all existing tags — pass the complete list of tag IDs you want on the record. To add a tag without removing others, first get-record to see current tags, then include them all.","tags":["tags-on-record"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID"},"tagIds":{"type":"array","items":{"type":"string"},"description":"Tag IDs to set on the record"}},"required":["workspaceId","recordId","tagIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-users":{"post":{"operationId":"list-users","summary":"List Users","description":"List users in the company or a specific workspace. By default lists all company users. Pass workspaceId to list only members of that workspace — useful for knowing who can be assigned to records.","tags":["user"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"description":"Workspace ID or slug to list only members of that workspace. Omit to list all company users.","type":"string"},"search":{"description":"Search by name or email","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"fullName":{"type":"string"},"isOnline":{"type":"boolean"},"lastActiveAt":{"type":"string","format":"date-time"}},"required":["id","email","firstName","lastName","fullName","isOnline"]}},"totalCount":{"type":"integer"}},"required":["users","totalCount"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-custom-fields":{"post":{"operationId":"list-custom-fields","summary":"List Custom Fields","description":"List custom fields defined in a workspace. Returns field names, types (text, number, dropdown, checkbox, etc.), and available options. Custom field values for a specific record are returned by get-record.","tags":["custom-field"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["CHECKBOX","CURRENCY","EMAIL","LOCATION","NUMBER","PERCENT","PHONE","RATING","SELECT_MULTI","SELECT_SINGLE","TEXT_MULTI","TEXT_SINGLE","UNIQUE_ID","URL","FILE","COUNTRY","DATE","FORMULA","REFERENCE","LOOKUP","TIME_DURATION","BUTTON","CURRENCY_CONVERSION","ASSIGNEE","REFERENCED_BY","ROLLUP","TABLE"]},"position":{"type":"number"},"description":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"currency":{"type":"string"},"prefix":{"type":"string"},"customFieldOptions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"},"position":{"type":"number"}},"required":["id","title","color","position"]}},"tableColumns":{}},"required":["id","name","type","position"]}},"pageInfo":{"type":"object","properties":{"totalItems":{"type":"integer"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/set-custom-field-value":{"post":{"operationId":"set-custom-field-value","summary":"Set Custom Field Value","description":"Set a custom field value on a record. Use list-custom-fields to find the field ID and type, then pass the appropriate value parameter for that type. Only provide the value parameters that match the field type.","tags":["custom-field-value"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID"},"customFieldId":{"type":"string","description":"The custom field ID (from list-custom-fields)"},"text":{"description":"Value for text, email, URL, or phone fields","type":"string"},"number":{"description":"Value for number or currency fields","type":"number"},"checked":{"description":"Value for checkbox fields","type":"boolean"},"customFieldOptionId":{"description":"Option ID for single-select dropdown fields","type":"string"},"customFieldOptionIds":{"description":"Option IDs for multi-select dropdown fields","type":"array","items":{"type":"string"}},"startDate":{"description":"Start date for date range fields (ISO 8601)","type":"string"},"endDate":{"description":"End date for date range fields (ISO 8601)","type":"string"},"timezone":{"description":"Timezone for date range fields (e.g. \"America/New_York\")","type":"string"},"latitude":{"description":"Latitude for location fields","type":"number"},"longitude":{"description":"Longitude for location fields","type":"number"},"regionCode":{"description":"Region code for phone fields (e.g. \"US\")","type":"string"},"currency":{"description":"Currency code for currency fields (e.g. \"USD\")","type":"string"},"customFieldReferenceTodoIds":{"description":"Record IDs for reference fields","type":"array","items":{"type":"string"}},"tableRows":{"description":"Rows for a Table field; each is { cells: { <columnId>: value } }. Get column IDs from list-custom-fields tableColumns. Replaces all existing rows.","type":"array","items":{"type":"object","properties":{"cells":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"position":{"type":"number"}},"required":["cells"],"additionalProperties":false}}},"required":["workspaceId","recordId","customFieldId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-checklist":{"post":{"operationId":"create-checklist","summary":"Create Checklist","description":"Create a new checklist on a record. A record can have multiple checklists. After creating, use create-checklist-item to add items to it.","tags":["checklist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recordId":{"type":"string","description":"The record ID to add the checklist to"},"title":{"type":"string","description":"Checklist title"}},"required":["recordId","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","uid","title","position","createdAt"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/create-checklist-item":{"post":{"operationId":"create-checklist-item","summary":"Create Checklist Item","description":"Add an item to an existing checklist. Requires a checklistId from create-checklist or get-record.","tags":["checklist-item"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"checklistId":{"type":"string","description":"The checklist ID"},"title":{"type":"string","description":"Item title"},"position":{"description":"Position in the checklist","type":"number"}},"required":["checklistId","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"done":{"type":"boolean"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","uid","title","position","done","createdAt"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/update-checklist-item":{"post":{"operationId":"update-checklist-item","summary":"Update Checklist Item","description":"Update a checklist item — toggle completion, rename, or reorder. Only provide the fields you want to change.","tags":["checklist-item"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"itemId":{"type":"string","description":"The checklist item ID"},"title":{"description":"New title","type":"string"},"done":{"description":"Mark as done/undone","type":"boolean"},"position":{"description":"New position","type":"number"}},"required":["itemId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"done":{"type":"boolean"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]}},"required":["id","uid","title","position","done"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/add-comment":{"post":{"operationId":"add-comment","summary":"Add Comment","description":"Add a comment to a record. Comments are visible to all workspace members. Supports plain text only.","tags":["comment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recordId":{"type":"string","description":"The record ID to comment on"},"text":{"type":"string","description":"Comment text (plain text)"}},"required":["recordId","text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"text":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"user":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"}},"required":["id","firstName","lastName"]}},"required":["id","uid","text","createdAt","user"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-activity":{"post":{"operationId":"list-activity","summary":"List Activity","description":"Read the activity feed — who did what, when — across the whole company or a single workspace. Omit workspaceId for company-wide activity. Use this to understand recent changes, audit actions, or catch up on a workspace. Newest first.","tags":["activity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"description":"Scope to one workspace. Omit for company-wide activity.","type":"string"},"userId":{"description":"Filter to activity by a specific user ID","type":"string"},"categories":{"description":"Filter by activity categories (e.g. CREATE_TODO, CREATE_COMMENT, COMPLETE_TODO). Omit for all.","type":"array","items":{"type":"string"}},"startDate":{"description":"Only activity at/after this time (ISO 8601)","type":"string"},"endDate":{"description":"Only activity at/before this time (ISO 8601)","type":"string"},"limit":{"description":"Maximum results (default: 20)","type":"number"},"after":{"description":"Pagination cursor (endCursor from a previous call)","type":"string"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"category":{"type":"string","enum":["REMOVE_TODO","REMOVE_TODO_LIST","CREATE_COMMENT","CREATE_DISCUSSION","CREATE_STATUS_UPDATE","CREATE_TODO","CREATE_TODO_LIST","COPY_TODO","EDIT_NAME","EDIT_JOB_TITLE","CREATE_INVITATION","CANCEL_INVITATION","ACCEPT_INVITATION","REJECT_INVITATION","ADD_USER_TO_PROJECT","REMOVE_USER_FROM_PROJECT","REMOVE_USER_FROM_COMPANY","LEAVE_COMPANY","LEAVE_PROJECT","MOVE_TODO","ARCHIVE_PROJECT","UNARCHIVE_PROJECT","REPEAT_TODO","UPDATE_COMPANY_ACCESS_LEVEL","UPDATE_PROJECT_ACCESS_LEVEL","CREATE_CUSTOM_FIELD","CREATE_QUESTION","MARK_TODO_AS_COMPLETE","ARCHIVE_TODO","UNARCHIVE_TODO","RECEIVE_FORM"]},"text":{"type":"string"},"html":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]},"affectedBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]},"todo":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"todoList":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}},"required":["id","category","text","html","createdAt","createdBy"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"endCursor":{"type":"string"}},"required":["hasNextPage"]},"totalCount":{"type":"integer"}},"required":["activities","pageInfo","totalCount"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-record-activity":{"post":{"operationId":"list-record-activity","summary":"List Record Activity","description":"Read the full history of a single record — its comments and its actions (field changes, moves, assignments, status changes). Use this to understand how a record reached its current state.","tags":["record-activity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID"},"type":{"description":"Filter to comments only, actions only, or all (default: all)","type":"string","enum":["all","comments","actions"]},"limit":{"description":"Maximum items, max 24 (default: 20)","type":"number"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"}},"required":["workspaceId","recordId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"__typename":{"type":"string"},"id":{"type":"string"},"html":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time"},"commentUser":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]},"type":{"type":"string","enum":["ADD_TAG","ASSIGN_AN_ASSIGNEE","ASSIGN_CHECKLIST_ITEM","CHANGE_DUE_DATE","CHANGE_TODO_LIST","COPY_TODO","CREATE_CHECKLIST","CREATE_CHECKLIST_ITEM","CREATE_DEPENDENCY","CREATE_FROM_FORM","DELETE_CHECKLIST","DELETE_CHECKLIST_ITEM","DELETE_DEPENDENCY","DELETE_TAG","MARK_AS_COMPLETE","MARK_AS_INCOMPLETE","MARK_CHECKLIST_ITEM_AS_DONE","MARK_CHECKLIST_ITEM_AS_UNDONE","MOVE_TODO","REMOVE_DUE_DATE","REMOVE_TAG","REPEAT_TODO","SET_CHECKLIST_ITEM_DUE_DATE","SET_CUSTOM_FIELD","SET_DUE_DATE","UNASSIGN_AN_ASSIGNEE","UNASSIGN_CHECKLIST_ITEM","UPDATE_CHECKLIST","UPDATE_CHECKLIST_ITEM","UPDATE_DEPENDENCY","UPDATE_DESCRIPTION","UPDATE_TAG","UPDATE_TITLE","SEND_EMAIL","ADD_TO_PROJECT","REMOVE_FROM_PROJECT"]},"oldValue":{"type":"string"},"newValue":{"type":"string"},"automated":{"type":"boolean"},"actionUser":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]},"affectedBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]},"customField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"required":["id","html","createdAt","commentUser","type"]}},"totalCount":{"type":"integer"}},"required":["items","totalCount"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-documents":{"post":{"operationId":"list-documents","summary":"List Documents","description":"List documents and wiki pages in a workspace (titles and metadata, no body). Use get-document for the full HTML content.","tags":["document"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"wiki":{"description":"Filter to wiki pages (true) or regular documents (false)","type":"boolean"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 20)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"wiki":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]}},"required":["id","uid","title","createdAt","updatedAt","project","createdBy"]}},"pageInfo":{"type":"object","properties":{"totalItems":{"type":"integer"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"]}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-document":{"post":{"operationId":"get-document","summary":"Get Document","description":"Get a single document or wiki page including its full HTML content. Use list-documents to find IDs.","tags":["document"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"string","description":"The document ID"},"workspaceId":{"description":"The workspace ID the document belongs to (recommended for scoping)","type":"string"}},"required":["documentId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"wiki":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]},"content":{"type":"string"}},"required":["id","uid","title","createdAt","updatedAt","project","createdBy"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-document":{"post":{"operationId":"manage-document","summary":"Manage Document","description":"Create, update, or delete a document or wiki page. create requires workspaceId; update and delete require documentId. Content is HTML.","tags":["document"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","delete"],"description":"The operation to perform"},"workspaceId":{"description":"Workspace ID (required for create)","type":"string"},"documentId":{"description":"Document ID (required for update and delete)","type":"string"},"title":{"description":"Document title","type":"string"},"content":{"description":"HTML content of the document","type":"string"},"wiki":{"description":"Whether this is a wiki page","type":"boolean"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-saved-views":{"post":{"operationId":"list-saved-views","summary":"List Saved Views","description":"List the saved views (saved record filters/layouts) in a workspace. Use get-saved-view to read a view's full configuration.","tags":["saved-view"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 100)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"},"position":{"type":"number"},"isShared":{"type":"boolean"},"viewType":{"type":"string","enum":["BOARD","DATABASE","CALENDAR","TIMELINE","MAP"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","uid","name","position","isShared","viewType","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"totalItems":{"type":"integer"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-saved-view":{"post":{"operationId":"get-saved-view","summary":"Get Saved View","description":"Get a single saved view including its viewConfig — the filter, sort, and grouping configuration. Inspect this to understand or reproduce how a team slices their records.","tags":["saved-view"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"viewId":{"type":"string","description":"The saved view ID"},"workspaceId":{"description":"The workspace ID the view belongs to (recommended for scoping)","type":"string"}},"required":["viewId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"},"position":{"type":"number"},"isShared":{"type":"boolean"},"viewType":{"type":"string","enum":["BOARD","DATABASE","CALENDAR","TIMELINE","MAP"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"viewConfig":{}},"required":["id","uid","name","position","isShared","viewType","createdAt","updatedAt","viewConfig"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-dependency":{"post":{"operationId":"manage-dependency","summary":"Manage Dependency","description":"Create, update, or delete a dependency between two records. type is from the perspective of recordId: BLOCKED_BY means recordId is blocked by otherRecordId; BLOCKING means recordId blocks otherRecordId. update changes an existing edge's type; delete removes the edge.","tags":["dependency"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","delete"],"description":"The operation to perform"},"recordId":{"type":"string","description":"The record (todo) ID"},"otherRecordId":{"type":"string","description":"The other record (todo) ID in the relationship"},"type":{"description":"Dependency type. Required for create/update; defaults to BLOCKED_BY on create.","type":"string","enum":["BLOCKING","BLOCKED_BY"]},"workspaceId":{"description":"Workspace ID for context (optional)","type":"string"}},"required":["action","recordId","otherRecordId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-reports":{"post":{"operationId":"list-reports","summary":"List Reports","description":"List reports in the company. Reports aggregate records across one or more workspaces. Use get-report for a report's full config and get-report-data for its records.","tags":["report"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results (default: 20)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"integer"},"hasNextPage":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"lastGeneratedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]}},"required":["id","uid","title","createdAt","updatedAt","createdBy"]}}},"required":["totalCount","hasNextPage","items"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-report":{"post":{"operationId":"get-report","summary":"Get Report","description":"Get a single report including its full config, data sources (workspaces + filters), and members.","tags":["report"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reportId":{"type":"string","description":"The report ID"}},"required":["reportId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"lastGeneratedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]},"config":{"type":"object"},"projectIds":{"type":"array","items":{"type":"string"}},"dataSources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"sourceType":{"type":"string","enum":["TODOS"]},"projectIds":{"type":"array","items":{"type":"string"}},"filters":{"type":"object"},"order":{"type":"integer"}},"required":["id","uid","sourceType","order"]}},"reportUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"role":{"type":"string","enum":["EDITOR","VIEWER"]},"user":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]}},"required":["id","role","user"]}}},"required":["id","uid","title","createdAt","updatedAt","createdBy","dataSources","reportUsers"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-report-data":{"post":{"operationId":"get-report-data","summary":"Get Report Data","description":"Get the records a report resolves to, plus the total count. The report's own data sources and filters apply; pass an optional additional filter to narrow further.","tags":["report-data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reportId":{"type":"string","description":"The report ID"},"filter":{"description":"Optional additional TodosFilter (e.g. { \"done\": false }) applied on top of the report","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"sort":{"description":"Optional TodosSort values","type":"array","items":{"type":"string"}},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of records (default: 50)","type":"number"}},"required":["reportId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"todoCount":{"type":"integer"},"todos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","title","done","createdAt","updatedAt"]}}},"required":["todoCount","todos"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-report":{"post":{"operationId":"manage-report","summary":"Manage Report","description":"Create, update, or delete a report. create builds a report over the given workspaces; update changes title/description; delete removes it. create requires title; update and delete require reportId.","tags":["report"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","delete"],"description":"The operation to perform"},"reportId":{"description":"Report ID (required for update and delete)","type":"string"},"title":{"description":"Report title (required for create)","type":"string"},"description":{"description":"Report description","type":"string"},"workspaceIds":{"description":"Workspace IDs to include as the report's data source (create only)","type":"array","items":{"type":"string"}},"filter":{"description":"Optional TodosFilter for the data source (create only)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-charts":{"post":{"operationId":"list-charts","summary":"List Charts","description":"List the charts in a dashboard, including each chart's computed segment values. Use this to read dashboard metrics (stats, bar/pie breakdowns).","tags":["chart"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dashboardId":{"type":"string","description":"The dashboard ID"}},"required":["dashboardId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"type":{"type":"string","enum":["STAT","PIE","BAR"]},"position":{"type":"number"},"isCalculating":{"type":"boolean"},"needCalculation":{"type":"boolean"},"chartSegments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"formulaResult":{"type":"number"}},"required":["id"]}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","title","type","position","chartSegments","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"totalItems":{"type":"integer"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-chart":{"post":{"operationId":"manage-chart","summary":"Manage Chart","description":"Delete a chart, or trigger recalculation of one or more charts (refresh their values after underlying records change). delete requires chartId; recalculate requires chartIds.","tags":["chart"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["delete","recalculate"],"description":"The operation to perform"},"chartId":{"description":"Chart ID (required for delete)","type":"string"},"chartIds":{"description":"Chart IDs to recalculate (required for recalculate)","type":"array","items":{"type":"string"}}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-dashboards":{"post":{"operationId":"list-dashboards","summary":"List Dashboards","description":"List dashboards in the company, optionally scoped to a workspace. Use list-charts with a dashboard ID to read its charts and values.","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"description":"Filter to dashboards scoped to this workspace","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results (default: 20)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]},"dashboardUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"role":{"type":"string","enum":["EDITOR","VIEWER"]},"user":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]}},"required":["id","role","user"]}}},"required":["id","title","createdAt","updatedAt","createdBy"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"totalItems":{"type":"integer"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-dashboard":{"post":{"operationId":"get-dashboard","summary":"Get Dashboard","description":"Get a single dashboard's metadata (title, owner, members). Use list-charts for its charts.","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dashboardId":{"type":"string","description":"The dashboard ID"}},"required":["dashboardId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]},"dashboardUsers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"role":{"type":"string","enum":["EDITOR","VIEWER"]},"user":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]}},"required":["id","role","user"]}}},"required":["id","title","createdAt","updatedAt","createdBy"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-dashboard":{"post":{"operationId":"manage-dashboard","summary":"Manage Dashboard","description":"Create or delete a dashboard. create requires title (optionally scope to a workspace); delete requires dashboardId and removes the dashboard and all its charts.","tags":["dashboard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","delete"],"description":"The operation to perform"},"title":{"description":"Dashboard title (required for create)","type":"string"},"workspaceId":{"description":"Scope the dashboard to a workspace (create only)","type":"string"},"dashboardId":{"description":"Dashboard ID (required for delete)","type":"string"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-custom-field":{"post":{"operationId":"manage-custom-field","summary":"Manage Custom Field","description":"Create, update, or delete a custom field DEFINITION in a workspace. (To read fields use list-custom-fields; to set a field value on a record use set-custom-field-value. For SELECT field options use manage-custom-field-options.) create requires workspaceId, name, and type; update and delete require customFieldId.","tags":["custom-field"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","delete"],"description":"The operation to perform"},"workspaceId":{"description":"Workspace ID (required for create; recommended for update/delete scoping)","type":"string"},"customFieldId":{"description":"Custom field ID (required for update and delete)","type":"string"},"name":{"description":"Field name (required for create)","type":"string"},"type":{"description":"Field type (required for create), e.g. TEXT_SINGLE, TEXT_MULTI, NUMBER, CURRENCY, PERCENT, DATE, SELECT_SINGLE, SELECT_MULTI, CHECKBOX, RATING, EMAIL, PHONE, URL, LOCATION, COUNTRY, FILE","type":"string"},"description":{"description":"Field description","type":"string"},"min":{"description":"Minimum value (NUMBER fields)","type":"number"},"max":{"description":"Maximum value (NUMBER fields)","type":"number"},"currency":{"description":"Currency code (CURRENCY fields), e.g. USD","type":"string"},"prefix":{"description":"Display prefix","type":"string"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-custom-field-options":{"post":{"operationId":"manage-custom-field-options","summary":"Manage Custom Field Options","description":"Add or remove options (choices) on a SELECT_SINGLE / SELECT_MULTI custom field. add appends one or more options; remove deletes one option by ID.","tags":["custom-field-option"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["add","remove"],"description":"The operation to perform"},"customFieldId":{"type":"string","description":"The custom field ID"},"options":{"description":"Options to add (required for add), each { title, color? }","type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"color":{"type":"string"}},"required":["title"],"additionalProperties":false}},"optionId":{"description":"Option ID to remove (required for remove)","type":"string"},"workspaceId":{"description":"Workspace ID for scoping (recommended)","type":"string"}},"required":["action","customFieldId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-forms":{"post":{"operationId":"list-forms","summary":"List Forms","description":"List the public/embedded forms in a workspace.","tags":["form"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"sort":{"description":"Sort order, e.g. updatedAt_DESC (default) or title_ASC","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results (default: 20)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"isActive":{"type":"boolean"},"theme":{"type":"string"},"primaryColor":{"type":"string"},"hideBranding":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","uid","title","isActive","theme","primaryColor","hideBranding","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"totalItems":{"type":"integer"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-form":{"post":{"operationId":"get-form","summary":"Get Form","description":"Get a single form including its full configuration and its fields (with custom-field links).","tags":["form"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"formId":{"type":"string","description":"The form ID"},"workspaceId":{"type":"string","description":"The workspace ID the form belongs to"}},"required":["formId","workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"footerText":{"type":"string"},"showFooter":{"type":"boolean"},"isActive":{"type":"boolean"},"theme":{"type":"string"},"primaryColor":{"type":"string"},"hideBranding":{"type":"boolean"},"responseText":{"type":"string"},"submitText":{"type":"string"},"imageURL":{"type":"string"},"redirectURL":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"todoList":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"formFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"field":{"type":"string"},"name":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"position":{"type":"number"},"addToDescription":{"type":"boolean"},"hidden":{"type":"boolean"},"extraInfo":{"type":"string"},"customField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["CHECKBOX","CURRENCY","EMAIL","LOCATION","NUMBER","PERCENT","PHONE","RATING","SELECT_MULTI","SELECT_SINGLE","TEXT_MULTI","TEXT_SINGLE","UNIQUE_ID","URL","FILE","COUNTRY","DATE","FORMULA","REFERENCE","LOOKUP","TIME_DURATION","BUTTON","CURRENCY_CONVERSION","ASSIGNEE","REFERENCED_BY","ROLLUP","TABLE"]}},"required":["id","name","type"]}},"required":["id","field","name","placeholder","required","position","addToDescription","hidden"]}}},"required":["id","uid","title","isActive","theme","primaryColor","hideBranding","createdAt","updatedAt","formFields"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-form":{"post":{"operationId":"manage-form","summary":"Manage Form","description":"Create, update, or delete a form. create requires workspaceId and title and configures the form in one call. update requires formId. delete requires formId. Add/edit form FIELDS with manage-form-field after the form exists.","tags":["form"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","delete"],"description":"The operation to perform"},"workspaceId":{"description":"Workspace ID (required for create)","type":"string"},"formId":{"description":"Form ID (required for update and delete)","type":"string"},"title":{"description":"Form title (required for create)","type":"string"},"description":{"description":"Form description","type":"string"},"primaryColor":{"description":"Hex primary color, e.g. #0066ff","type":"string"},"hideBranding":{"description":"Hide Blue branding","type":"boolean"},"theme":{"description":"Theme: light or dark","type":"string"},"submitText":{"description":"Submit button label","type":"string"},"responseText":{"description":"Post-submit response text","type":"string"},"redirectUrl":{"description":"URL to redirect to after submit","type":"string"},"imageUrl":{"description":"Header image URL","type":"string"},"footerText":{"description":"Footer text","type":"string"},"showFooter":{"description":"Show the footer","type":"boolean"},"listId":{"description":"List ID that submissions land in","type":"string"},"assigneeIds":{"description":"User IDs to assign to new records","type":"array","items":{"type":"string"}},"tagIds":{"description":"Tag IDs to apply to new records","type":"array","items":{"type":"string"}},"isActive":{"description":"Whether the form is live","type":"boolean"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-form-field":{"post":{"operationId":"manage-form-field","summary":"Manage Form Field","description":"Add, update, or delete a field on a form. For upsert: omit formFieldId to add a new field, or pass an existing formFieldId to edit it. field is one of title, description, tags, startedAt, duedAt, custom; only custom carries a customFieldId. delete requires formFieldId.","tags":["form-field"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["upsert","delete"],"description":"The operation to perform"},"formId":{"description":"The form ID (required for upsert)","type":"string"},"formFieldId":{"description":"Form field ID — omit to add a new field, provide to edit; required for delete","type":"string"},"field":{"description":"Field type (required for upsert)","type":"string","enum":["title","description","tags","startedAt","duedAt","custom"]},"customFieldId":{"description":"Custom field ID (only when field is \"custom\")","type":"string"},"name":{"description":"Field label shown on the form","type":"string"},"placeholder":{"description":"Placeholder text","type":"string"},"position":{"description":"Ordering position (e.g. 1000, 2000)","type":"number"},"required":{"description":"Whether the field is required","type":"boolean"},"hidden":{"description":"Whether the field is hidden (defaults to false)","type":"boolean"},"addToDescription":{"description":"Render the value into the record description","type":"boolean"},"extraInfo":{"description":"Extra helper text","type":"string"},"workspaceId":{"description":"Workspace ID for scoping (recommended)","type":"string"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-automations":{"post":{"operationId":"list-automations","summary":"List Automations","description":"List the automations in a workspace, summarizing each one's trigger and actions. Use this to audit what automated behavior a workspace has configured.","tags":["automation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results (default: 50)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"isActive":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"trigger":{"type":"object","properties":{"type":{"type":"string","enum":["TODO_CREATED","TODO_LIST_CHANGED","TODO_MARKED_AS_COMPLETE","TODO_MARKED_AS_INCOMPLETE","ASSIGNEE_ADDED","ASSIGNEE_REMOVED","DUE_DATE_CHANGED","DUE_DATE_REMOVED","TAG_ADDED","TAG_REMOVED","CHECKLIST_ITEM_MARKED_AS_DONE","CHECKLIST_ITEM_MARKED_AS_UNDONE","DUE_DATE_EXPIRED","TODO_ARCHIVED","TODO_UNARCHIVED","TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT","CUSTOM_FIELD_ADDED","CUSTOM_FIELD_REMOVED","COLOR_ADDED","COLOR_REMOVED","CUSTOM_FIELD_BUTTON_CLICKED","PROJECT_ADDED_TO_TODO","SCHEDULED","CONDITIONAL","COMMENT_ADDED"]},"customField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"todoList":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]}},"color":{"type":"string"}},"required":["type"]},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CHANGE_TODO_LIST","MARK_AS_COMPLETE","MARK_AS_INCOMPLETE","ADD_ASSIGNEE","REMOVE_ASSIGNEE","CHANGE_DUE_DATE","REMOVE_DUE_DATE","ADD_TAG","REMOVE_TAG","MARK_CHECKLIST_ITEM_AS_DONE","MARK_CHECKLIST_ITEM_AS_UNDONE","CREATE_CHECKLIST","COPY_TODO","SEND_EMAIL","ADD_CUSTOM_FIELD","REMOVE_CUSTOM_FIELD","ADD_COLOR","REMOVE_COLOR","GENERATE_PDF","MAKE_HTTP_REQUEST","ADD_ASSIGNEE_TRIGGERER","REMOVE_ASSIGNEE_TRIGGERER","ADD_PROJECT","ARCHIVE_TODO","UNARCHIVE_TODO"]},"customField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"todoList":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"}},"required":["id","fullName"]}},"color":{"type":"string"}},"required":["type"]}}},"required":["id","isActive","createdAt","updatedAt","trigger","actions"]}}},"required":["totalCount","items"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-automation":{"post":{"operationId":"manage-automation","summary":"Manage Automation","description":"Enable, disable, or delete an automation. (Creating automations is done in-app — their trigger/action config is too structured for a tool.)","tags":["automation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["enable","disable","delete"],"description":"The operation to perform"},"automationId":{"type":"string","description":"The automation ID"},"workspaceId":{"description":"Workspace ID for scoping (recommended)","type":"string"}},"required":["action","automationId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-webhooks":{"post":{"operationId":"list-webhooks","summary":"List Webhooks","description":"List the webhooks configured for the account. Use get-webhook for the signing secret.","tags":["webhook"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabledOnly":{"description":"Only return enabled webhooks","type":"boolean"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results (default: 50)","type":"number"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["HEALTHY","UNHEALTHY"]},"events":{"type":"array","items":{"type":"string","enum":["TODO_CREATED","TODO_DELETED","TODO_MOVED","TODO_NAME_CHANGED","TODO_DONE_STATUS_UPDATED","TODO_DUE_DATE_ADDED","TODO_DUE_DATE_UPDATED","TODO_DUE_DATE_REMOVED","TODO_ASSIGNEE_ADDED","TODO_ASSIGNEE_REMOVED","TODO_TAG_ADDED","TODO_TAG_REMOVED","TODO_CUSTOM_FIELD_UPDATED","TODO_CHECKLIST_CREATED","TODO_CHECKLIST_NAME_CHANGED","TODO_CHECKLIST_DELETED","TODO_CHECKLIST_ITEM_CREATED","TODO_CHECKLIST_ITEM_NAME_CHANGED","TODO_CHECKLIST_ITEM_DELETED","TODO_CHECKLIST_ITEM_DUE_DATE_ADDED","TODO_CHECKLIST_ITEM_DUE_DATE_UPDATED","TODO_CHECKLIST_ITEM_DUE_DATE_REMOVED","TODO_CHECKLIST_ITEM_ASSIGNEE_ADDED","TODO_CHECKLIST_ITEM_ASSIGNEE_REMOVED","TODO_CHECKLIST_ITEM_DONE_STATUS_UPDATED","TODO_LIST_CREATED","TODO_LIST_DELETED","TODO_LIST_NAME_CHANGED","CUSTOM_FIELD_CREATED","CUSTOM_FIELD_DELETED","CUSTOM_FIELD_UPDATED","TAG_CREATED","TAG_DELETED","TAG_UPDATED","COMMENT_CREATED","COMMENT_DELETED","COMMENT_UPDATED"]}},"projectIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","uid","url","status","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"totalItems":{"type":"integer"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/get-webhook":{"post":{"operationId":"get-webhook","summary":"Get Webhook","description":"Get a single webhook including its signing secret and metadata.","tags":["webhook"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"webhookId":{"type":"string","description":"The webhook ID"}},"required":["webhookId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"status":{"type":"string","enum":["HEALTHY","UNHEALTHY"]},"events":{"type":"array","items":{"type":"string","enum":["TODO_CREATED","TODO_DELETED","TODO_MOVED","TODO_NAME_CHANGED","TODO_DONE_STATUS_UPDATED","TODO_DUE_DATE_ADDED","TODO_DUE_DATE_UPDATED","TODO_DUE_DATE_REMOVED","TODO_ASSIGNEE_ADDED","TODO_ASSIGNEE_REMOVED","TODO_TAG_ADDED","TODO_TAG_REMOVED","TODO_CUSTOM_FIELD_UPDATED","TODO_CHECKLIST_CREATED","TODO_CHECKLIST_NAME_CHANGED","TODO_CHECKLIST_DELETED","TODO_CHECKLIST_ITEM_CREATED","TODO_CHECKLIST_ITEM_NAME_CHANGED","TODO_CHECKLIST_ITEM_DELETED","TODO_CHECKLIST_ITEM_DUE_DATE_ADDED","TODO_CHECKLIST_ITEM_DUE_DATE_UPDATED","TODO_CHECKLIST_ITEM_DUE_DATE_REMOVED","TODO_CHECKLIST_ITEM_ASSIGNEE_ADDED","TODO_CHECKLIST_ITEM_ASSIGNEE_REMOVED","TODO_CHECKLIST_ITEM_DONE_STATUS_UPDATED","TODO_LIST_CREATED","TODO_LIST_DELETED","TODO_LIST_NAME_CHANGED","CUSTOM_FIELD_CREATED","CUSTOM_FIELD_DELETED","CUSTOM_FIELD_UPDATED","TAG_CREATED","TAG_DELETED","TAG_UPDATED","COMMENT_CREATED","COMMENT_DELETED","COMMENT_UPDATED"]}},"projectIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"secret":{"type":"string"},"metadata":{}},"required":["id","uid","url","status","createdAt","updatedAt"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/manage-webhook":{"post":{"operationId":"manage-webhook","summary":"Manage Webhook","description":"Create, update, disable, or delete a webhook. create requires url; update/disable/delete require webhookId. Re-enable a disabled webhook with update + enabled: true.","tags":["webhook"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["create","update","disable","delete"],"description":"The operation to perform"},"webhookId":{"description":"Webhook ID (required for update/disable/delete)","type":"string"},"url":{"description":"Endpoint URL (required for create)","type":"string"},"name":{"description":"Webhook name","type":"string"},"events":{"description":"Event names to subscribe to. Omit/empty to receive all events.","type":"array","items":{"type":"string"}},"workspaceIds":{"description":"Restrict the webhook to these workspace IDs (omit for all)","type":"array","items":{"type":"string"}},"enabled":{"description":"Enable/disable (update only)","type":"boolean"}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/list-files":{"post":{"operationId":"list-files","summary":"List Files","description":"List files uploaded in a workspace (metadata: name, size, type, which record/folder, uploader). Optionally filter by name. Binary download is not available through this tool.","tags":["file"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"search":{"description":"Filter by file name","type":"string"},"skip":{"description":"Offset for pagination (default: 0)","type":"number"},"limit":{"description":"Number of results, max 100 (default: 50)","type":"number"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"name":{"type":"string"},"size":{"type":"number"},"type":{"type":"string"},"extension":{"type":"string"},"status":{"type":"string","enum":["CONFIRMED","PENDING"]},"shared":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"folder":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"todo":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"user":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"email":{"type":"string"}},"required":["id","fullName","email"]}},"required":["id","uid","name","size","type","extension","shared","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"totalItems":{"type":"integer"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]}},"/records":{"get":{"operationId":"get-records","summary":"List records","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"archived":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]},"color":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"}},"required":["id","firstName","lastName","email"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}}},"required":["id","uid","title","done","archived","position","createdAt","updatedAt","list","users","tags"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"hasPreviousPage":{"type":"boolean"},"startCursor":{"type":"string"},"endCursor":{"type":"string"}},"required":["hasNextPage","hasPreviousPage"]}},"required":["items","pageInfo"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"post-records","summary":"Create a record","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]}},"required":["id","uid","title","position","list"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID to create the record in"},"title":{"type":"string","description":"Record title"},"listId":{"description":"List ID to place the record in. If omitted, uses the first list.","type":"string"},"description":{"description":"Record description (plain text)","type":"string"},"startedAt":{"description":"Start date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"duedAt":{"description":"Due date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"allDay":{"description":"Force the dates to be all-day (a floating calendar date shown identically in every timezone) or timed. Usually unnecessary: bare YYYY-MM-DD dates are all-day automatically.","type":"boolean"},"assigneeIds":{"description":"User IDs to assign","type":"array","items":{"type":"string"}},"tagIds":{"description":"Tag IDs to apply","type":"array","items":{"type":"string"}}},"required":["workspaceId","title"],"additionalProperties":false}}}}}},"/records/{id}":{"get":{"operationId":"get-records--id","summary":"Get a record","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"},"done":{"type":"boolean"},"archived":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]},"color":{"type":"string"},"cover":{"type":"string"},"commentCount":{"type":"integer"},"checklistCount":{"type":"integer"},"checklistCompletedCount":{"type":"integer"},"isRepeating":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"list":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"]},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"}},"required":["id","firstName","lastName","email"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}},"checklists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"checklistItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"},"position":{"type":"number"},"startedAt":{"type":"string","format":"date-time"},"duedAt":{"type":"string","format":"date-time"},"dueDateGranularity":{"type":"string","enum":["ALL_DAY","TIMED"]}},"required":["id","title","done","position"]}}},"required":["id","title","position","checklistItems"]}},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["CHECKBOX","CURRENCY","EMAIL","LOCATION","NUMBER","PERCENT","PHONE","RATING","SELECT_MULTI","SELECT_SINGLE","TEXT_MULTI","TEXT_SINGLE","UNIQUE_ID","URL","FILE","COUNTRY","DATE","FORMULA","REFERENCE","LOOKUP","TIME_DURATION","BUTTON","CURRENCY_CONVERSION","ASSIGNEE","REFERENCED_BY","ROLLUP","TABLE"]},"text":{"type":"string"},"number":{"type":"number"},"checked":{"type":"boolean"},"customFieldOptions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"color":{"type":"string"}},"required":["id","title","color"]}},"tableColumns":{},"tableRows":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"cells":{}},"required":["position","cells"]}},"tableTotals":{}},"required":["id","name","type"]}}},"required":["id","uid","title","text","html","done","archived","position","commentCount","checklistCount","checklistCompletedCount","isRepeating","createdAt","updatedAt","list","users","tags","checklists","customFields"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patch-records--id","summary":"Update a record","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID to update"},"title":{"description":"New title","type":"string"},"description":{"description":"New description (plain text)","type":"string"},"done":{"description":"Set the done status. Pass true to mark as done, false to mark as not done.","type":"boolean"},"startedAt":{"description":"Start date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"duedAt":{"description":"Due date. Send a bare YYYY-MM-DD for an all-day date, or ISO 8601 for a timed one.","type":"string"},"allDay":{"description":"Force the dates to be all-day (a floating calendar date shown identically in every timezone) or timed. Usually unnecessary: bare YYYY-MM-DD dates are all-day automatically.","type":"boolean"},"color":{"description":"Record color","type":"string"},"assigneeIds":{"description":"User IDs to assign. Replaces all current assignees.","type":"array","items":{"type":"string"}}},"required":["workspaceId","recordId"],"additionalProperties":false}}}}},"delete":{"operationId":"delete-records--id","summary":"Delete a record","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspaceId","in":"query","required":true,"schema":{"type":"string"}}]}},"/records/{id}/move":{"post":{"operationId":"post-records--id-move","summary":"Move a record to another list","tags":["record"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID the record belongs to"},"recordId":{"type":"string","description":"The record ID to move"},"listId":{"type":"string","description":"The target list ID"}},"required":["workspaceId","recordId","listId"],"additionalProperties":false}}}}}},"/workspaces":{"get":{"operationId":"get-workspaces","summary":"List workspaces","tags":["workspace"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"archived":{"type":"boolean"},"color":{"type":"string"},"icon":{"type":"string"},"category":{"type":"string","enum":["CRM","CROSS_FUNCTIONAL","CUSTOMER_SUCCESS","DESIGN","ENGINEERING","GENERAL","HR","IT","MARKETING","OPERATIONS","PRODUCT","SALES"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","uid","slug","name","category","createdAt","updatedAt"]}},"totalCount":{"type":"integer"}},"required":["items"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"post-workspaces","summary":"Create a workspace","tags":["workspace"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"color":{"type":"string"},"icon":{"type":"string"},"category":{"type":"string","enum":["CRM","CROSS_FUNCTIONAL","CUSTOMER_SUCCESS","DESIGN","ENGINEERING","GENERAL","HR","IT","MARKETING","OPERATIONS","PRODUCT","SALES"]}},"required":["id","uid","slug","name","category"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Workspace name"},"description":{"description":"Workspace description","type":"string"},"color":{"description":"Workspace color (hex code)","type":"string"},"icon":{"description":"Workspace icon","type":"string"},"category":{"description":"Workspace category","type":"string"}},"required":["name"],"additionalProperties":false}}}}}},"/lists":{"get":{"operationId":"get-lists","summary":"List lists","tags":["list"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"completed":{"type":"boolean"},"isLocked":{"type":"boolean"},"isDisabled":{"type":"boolean"},"todosCount":{"type":"integer"}},"required":["id","uid","title","position","isDisabled","todosCount"]}}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"post-lists","summary":"Create a list","tags":["list"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uid":{"type":"string"},"title":{"type":"string"},"position":{"type":"number"},"completed":{"type":"boolean"},"isLocked":{"type":"boolean"},"isDisabled":{"type":"boolean"}},"required":["id","uid","title","position","isDisabled"]}}}},"400":{"description":"Invalid input"},"401":{"description":"Unauthorized"},"422":{"description":"Operation error"}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID"},"title":{"type":"string","description":"The title of the list"},"position":{"description":"Position of the list (determines order). If omitted, the list is appended at the end. Use list-lists to see existing positions.","type":"number"}},"required":["workspaceId","title"],"additionalProperties":false}}}}}}}}