{ "openapi": "3.1.0", "info": { "title": "Ceyu Public API", "version": "2026-08-03", "description": "Organization-scoped API for Ceyu Studio and Enterprise." }, "servers": [ { "url": "https://api.ceyu.org" } ], "paths": { "/v1": { "get": { "operationId": "root", "summary": "Describes the active Ceyu public API version.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "const": "api_ceyu" }, "object": { "type": "string", "const": "api" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "version": { "type": "string", "const": "2026-08-03" }, "livemode": { "type": "boolean" } }, "required": [ "id", "object", "created", "version", "livemode" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "plan_required", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/me": { "get": { "operationId": "me", "summary": "Returns the organization, scopes, version, and limits for this key.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "api_identity" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "organization": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "object": { "type": "string", "const": "organization" } }, "required": [ "id", "object" ], "additionalProperties": false }, "owner": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "organization", "user", "application" ] }, "id": { "type": "string", "minLength": 1 } }, "required": [ "type", "id" ], "additionalProperties": false }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "api:read", "api:manage", "workspaces:read", "workspaces:write", "projects:read", "projects:write", "tasks:read", "tasks:write", "comments:read", "comments:write", "time_entries:read", "time_entries:write", "billing:read", "billing:write", "boards:read", "boards:write", "automations:read", "automations:write", "files:read", "files:write" ] } }, "plan": { "type": "string", "enum": [ "studio", "enterprise" ] }, "mode": { "type": "string", "enum": [ "live", "test" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "limits": { "type": "object", "properties": { "credits_per_minute": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "credits_per_day": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "credits_per_minute", "credits_per_day" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "organization", "owner", "scopes", "plan", "mode", "api_version", "limits" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "plan_required", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/organizations/{id}": { "get": { "operationId": "organizations_get", "summary": "Retrieves the organization bound to the authenticated credential.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "organization" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "plan": { "type": "string", "enum": [ "studio", "enterprise" ] }, "domains": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string", "minLength": 1, "maxLength": 253 }, "state": { "type": "string", "minLength": 1, "maxLength": 80 } }, "required": [ "domain", "state" ], "additionalProperties": false } } }, "required": [ "id", "object", "created", "updated", "name", "plan", "domains" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/members": { "get": { "operationId": "members_list", "summary": "Lists organization members from the identity source of truth.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "member" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "email": { "anyOf": [ { "type": "string", "maxLength": 320, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "profile_picture_url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "active", "inactive", "pending" ] } }, "required": [ "id", "object", "created", "updated", "user", "email", "first_name", "last_name", "profile_picture_url", "role", "status" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "member" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "email": { "anyOf": [ { "type": "string", "maxLength": 320, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "profile_picture_url": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "active", "inactive", "pending" ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/teams": { "get": { "operationId": "teams_list", "summary": "Lists organization teams from WorkOS groups.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "team" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "name", "description" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "team" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/api_keys": { "get": { "operationId": "api_keys_list", "summary": "Lists organization API keys without exposing secret values.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "api_key" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "obfuscated_value": { "type": "string", "minLength": 1, "maxLength": 200 }, "owner": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "organization", "user" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "organization_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "required": [ "type", "id", "organization_id" ], "additionalProperties": false }, "scopes": { "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "api:read", "api:manage", "workspaces:read", "workspaces:write", "projects:read", "projects:write", "tasks:read", "tasks:write", "comments:read", "comments:write", "time_entries:read", "time_entries:write", "billing:read", "billing:write", "boards:read", "boards:write", "automations:read", "automations:write", "files:read", "files:write" ] } }, "last_used_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "name", "obfuscated_value", "owner", "scopes", "last_used_at", "expires_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "api_key" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "obfuscated_value": { "type": "string", "minLength": 1, "maxLength": 200 }, "owner": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "organization", "user" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "organization_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "required": [ "type", "id", "organization_id" ], "additionalProperties": false }, "scopes": { "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "api:read", "api:manage", "workspaces:read", "workspaces:write", "projects:read", "projects:write", "tasks:read", "tasks:write", "comments:read", "comments:write", "time_entries:read", "time_entries:write", "billing:read", "billing:write", "boards:read", "boards:write", "automations:read", "automations:write", "files:read", "files:write" ] } }, "last_used_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "api_keys_create", "summary": "Creates an organization API key and returns its secret exactly once.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "scopes": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "api:read", "api:manage", "workspaces:read", "workspaces:write", "projects:read", "projects:write", "tasks:read", "tasks:write", "comments:read", "comments:write", "time_entries:read", "time_entries:write", "billing:read", "billing:write", "boards:read", "boards:write", "automations:read", "automations:write", "files:read", "files:write" ] } }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "name", "scopes" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "api_key" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "obfuscated_value": { "type": "string", "minLength": 1, "maxLength": 200 }, "owner": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "organization", "user" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "organization_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "required": [ "type", "id", "organization_id" ], "additionalProperties": false }, "scopes": { "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "api:read", "api:manage", "workspaces:read", "workspaces:write", "projects:read", "projects:write", "tasks:read", "tasks:write", "comments:read", "comments:write", "time_entries:read", "time_entries:write", "billing:read", "billing:write", "boards:read", "boards:write", "automations:read", "automations:write", "files:read", "files:write" ] } }, "last_used_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "value": { "type": "string", "minLength": 16, "maxLength": 24576 } }, "required": [ "id", "object", "created", "updated", "name", "obfuscated_value", "owner", "scopes", "last_used_at", "expires_at", "value" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/api_keys/{id}": { "delete": { "operationId": "api_keys_delete", "summary": "Revokes a key locally before permanently deleting it in WorkOS.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "api_key" }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/usage": { "get": { "operationId": "usage_get", "summary": "Returns the current credential credit window and plan day limit.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "object": { "type": "string", "const": "api_usage" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "plan": { "type": "string", "enum": [ "studio", "enterprise" ] }, "current_window": { "type": "object", "properties": { "limit": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "remaining": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "limit", "remaining", "reset" ], "additionalProperties": false }, "daily_limit": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "daily_usage": { "type": "object", "properties": { "used": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "remaining": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "requests": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "used", "remaining", "requests", "reset" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "plan", "current_window", "daily_limit", "daily_usage" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/request_logs/{id}": { "get": { "operationId": "request_logs_get", "summary": "Retrieves seven-day diagnostic metadata for one request id.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "api_request_log" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endpoint": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": [ "GET", "POST", "PATCH", "DELETE" ] }, "route": { "type": "string", "maxLength": 500, "pattern": "^\\/v1(?:\\/|$)" }, "status": { "type": "integer", "minimum": 100, "maximum": 599 }, "credits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "error_code": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "endpoint", "method", "route", "status", "credits", "duration_ms", "error_code" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/audit_logs": { "get": { "operationId": "audit_logs_list", "summary": "Lists retained organization audit entries without secret payload data.", "tags": [ "platform" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "action", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 512 } }, { "name": "actor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "room", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "target", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "created_after", "in": "query", "required": false, "schema": {} }, { "name": "created_before", "in": "query", "required": false, "schema": {} } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "audit_log" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "action": { "type": "string", "minLength": 1, "maxLength": 512 }, "actor": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] }, "room": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "target": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "action", "actor", "room", "target", "decision" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "audit_log" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "action": { "type": "string", "minLength": 1, "maxLength": 512 }, "actor": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] }, "room": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "target": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards": { "get": { "operationId": "boards_list", "summary": "Lists organization boards with snapshot freshness metadata.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "include_archived", "in": "query", "required": false, "schema": {} } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "snapshot_revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "revision", "name", "description", "archived_at", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "snapshot_revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "boards:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "boards_create", "summary": "Creates a board and its durable API service-user ownership record.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "snapshot_revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "revision", "name", "description", "archived_at", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards/{id}": { "get": { "operationId": "boards_get", "summary": "Retrieves one organization board by public or legacy room id.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "snapshot_revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "revision", "name", "description", "archived_at", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "boards:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "boards_update", "summary": "Updates board metadata with optional revision-based If-Match protection.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "snapshot_revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "revision", "name", "description", "archived_at", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "boards_delete", "summary": "Archives a board as a recoverable deletion and emits its deletion event.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "object": { "type": "string", "const": "board" }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards/{id}/items": { "get": { "operationId": "board_items_list", "summary": "Lists a board's items from one complete, revision-bound materialized snapshot.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_item" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "data": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "snapshot_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "board", "type", "data", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_item" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "data": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "snapshot_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "boards:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards/{id}/items/{item_id}": { "get": { "operationId": "board_items_get", "summary": "Retrieves one item from the board's currently published snapshot.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_item" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "type": { "type": "string", "minLength": 1, "maxLength": 80 }, "data": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "snapshot_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "snapshot_created_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "board", "type", "data", "snapshot_revision", "snapshot_created_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "boards:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards/{id}/members": { "get": { "operationId": "board_members_list", "summary": "Lists board memberships from the tenant-scoped authorization mirror.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_member" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "role": { "type": "string", "enum": [ "owner", "editor", "viewer" ] }, "joined": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "board", "user", "role", "joined" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_member" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "role": { "type": "string", "enum": [ "owner", "editor", "viewer" ] }, "joined": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "boards:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "board_members_create", "summary": "Adds or re-shares a board with an active organization member.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "role": { "type": "string", "enum": [ "editor", "viewer" ] } }, "required": [ "user", "role" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_member" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "role": { "type": "string", "enum": [ "owner", "editor", "viewer" ] }, "joined": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "board", "user", "role", "joined" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/boards/{id}/members/{user_id}": { "patch": { "operationId": "board_members_update", "summary": "Changes a non-owner board membership in WorkOS and D1 consistently.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "editor", "viewer" ] } }, "required": [ "role" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_member" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "role": { "type": "string", "enum": [ "owner", "editor", "viewer" ] }, "joined": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "board", "user", "role", "joined" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "board_members_delete", "summary": "Revokes a non-owner board membership in WorkOS and D1.", "tags": [ "whiteboard" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "board_member" }, "board": { "type": "string", "pattern": "^[a-z][a-z0-9]{1,7}_[0-9A-HJKMNP-TV-Z]{26}$" }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "board", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "boards:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/workspaces": { "get": { "operationId": "workspaces_list", "summary": "Lists active FlowTask workspaces in the authenticated organization.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "workspace" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 500 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "title", "revision", "archived_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "workspace" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 500 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "workspaces:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "workspaces_create", "summary": "Creates a workspace through the synchronized operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "title" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "workspace" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 500 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "title", "revision", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "workspaces:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/workspaces/{id}": { "get": { "operationId": "workspaces_get", "summary": "Retrieves one FlowTask workspace.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "workspace" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 500 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "title", "revision", "archived_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "workspaces:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "workspaces_update", "summary": "Updates workspace metadata through the synchronized operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 500 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "workspace" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 500 }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "title", "revision", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "workspaces:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/projects": { "get": { "operationId": "projects_list", "summary": "Lists FlowTask projects with stable cursor pagination.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "projects_create", "summary": "Creates a project through the FlowTask operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "required": [ "workspace", "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/portfolios": { "get": { "operationId": "portfolios_list", "summary": "Lists FlowTask portfolios with stable ID cursor pagination.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "portfolio" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "archived_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "portfolio" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "portfolios_create", "summary": "Creates a portfolio through the FlowTask operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 } }, "required": [ "workspace", "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "portfolio" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/portfolios/{id}": { "get": { "operationId": "portfolios_get", "summary": "Retrieves one FlowTask portfolio.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "portfolio" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "archived_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "portfolios_update", "summary": "Updates selected portfolio fields.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "portfolio" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "portfolios_delete", "summary": "Deletes a portfolio and retains a synchronization tombstone.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/columns": { "get": { "operationId": "columns_list", "summary": "Lists project columns in an organization workspace.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "position", "color" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "columns_create", "summary": "Creates a project column through the operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "workspace", "project", "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "position", "color" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/columns/{id}": { "get": { "operationId": "columns_get", "summary": "Retrieves one project column.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "position", "color" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "columns_update", "summary": "Updates a project column without replacing it.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "position", "color" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "columns_delete", "summary": "Deletes a project column through the synchronization protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/columns/reorder": { "post": { "operationId": "columns_reorder", "summary": "Reorders up to 100 project columns in one workspace revision.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "data": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "position": { "type": "number" } }, "required": [ "id", "position" ], "additionalProperties": false } } }, "required": [ "workspace", "project", "data" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "position", "color" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "column" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "position": { "type": "number" }, "color": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 25, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/projects/{id}": { "get": { "operationId": "projects_get", "summary": "Retrieves one FlowTask project.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "projects_update", "summary": "Updates selected project fields without replacing the object.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "projects_delete", "summary": "Deletes a project through a retained FlowTask tombstone.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks": { "get": { "operationId": "tasks_list", "summary": "Lists FlowTask tasks with workspace and project filters.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "expand", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^(?:project|assignee)(?:,(?:project|assignee)){0,2}$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } } ] } }, { "name": "assignee", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ] } }, { "name": "due_before", "in": "query", "required": false, "schema": {} }, { "name": "is_archived", "in": "query", "required": false, "schema": {} }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "due_at", "-due_at", "created", "-created" ] } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "tasks_create", "summary": "Creates a task through the FlowTask operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "title": { "type": "string", "minLength": 1, "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "workspace", "title" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/count": { "get": { "operationId": "tasks_count", "summary": "Counts matching tasks with a tenant-isolated 60-second cache.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 120 }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } } ] } }, { "name": "assignee", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ] } }, { "name": "due_before", "in": "query", "required": false, "schema": {} }, { "name": "is_archived", "in": "query", "required": false, "schema": {} }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "const": "tasks" }, "object": { "type": "string", "const": "count" }, "count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cached_until": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "count", "cached_until" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 50, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{id}": { "get": { "operationId": "tasks_get", "summary": "Retrieves one FlowTask task.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "tasks_update", "summary": "Patches task fields with optional entity-revision If-Match.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "title": { "type": "string", "minLength": 1, "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "tasks_delete", "summary": "Deletes a task and creates its synchronization tombstone.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{task_id}/comments": { "get": { "operationId": "task_comments_list", "summary": "Lists comments for one FlowTask task.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "comment" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "author": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "body": { "type": "string", "maxLength": 100000 } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "revision", "author", "body" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "comment" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "author": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "body": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "comments:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "task_comments_create", "summary": "Creates a comment attributed to the API service user.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "body": { "type": "string", "minLength": 1, "maxLength": 100000 } }, "required": [ "workspace", "body" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "comment" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "author": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "body": { "type": "string", "maxLength": 100000 } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "revision", "author", "body" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "comments:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{task_id}/comments/{id}": { "get": { "operationId": "task_comments_get", "summary": "Retrieves one comment belonging to a FlowTask task.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "comment" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "author": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "body": { "type": "string", "maxLength": 100000 } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "revision", "author", "body" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "comments:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "task_comments_update", "summary": "Updates a task comment through the operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "body": { "type": "string", "minLength": 1, "maxLength": 100000 } }, "required": [ "body" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "comment" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "author": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "body": { "type": "string", "maxLength": 100000 } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "revision", "author", "body" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "comments:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "task_comments_delete", "summary": "Deletes a task comment and retains a tombstone.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "comments:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{task_id}/dependencies": { "get": { "operationId": "task_dependencies_list", "summary": "Lists outgoing dependencies for one task.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "dependency" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "from": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "to": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "kind": { "type": "string", "enum": [ "FS", "SS", "FF", "SF" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "from", "to", "kind", "revision" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "dependency" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "from": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "to": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "kind": { "type": "string", "enum": [ "FS", "SS", "FF", "SF" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "task_dependencies_create", "summary": "Creates a dependency between tasks in the same project.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "to": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "kind": { "type": "string", "enum": [ "FS", "SS", "FF", "SF" ] } }, "required": [ "workspace", "to" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "dependency" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "from": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "to": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "kind": { "type": "string", "enum": [ "FS", "SS", "FF", "SF" ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "from", "to", "kind", "revision" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/time_entries": { "get": { "operationId": "time_entries_list", "summary": "Lists FlowTask time entries with workspace and task filters.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "task", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "time_entries:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "time_entries_create", "summary": "Creates a time entry through the FlowTask operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 31536000000 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "workspace", "task" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "time_entries:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/time_entries/{id}": { "get": { "operationId": "time_entries_get", "summary": "Retrieves one FlowTask time entry.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "time_entries:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "time_entries_update", "summary": "Updates selected time-entry fields.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 31536000000 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "time_entries:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "time_entries_delete", "summary": "Deletes a time entry through the operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "time_entries:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/saved_filters": { "get": { "operationId": "saved_filters_list", "summary": "Lists team-visible saved filters without exposing private user filters.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "saved_filter" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "owner": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "visibility": { "type": "string", "enum": [ "private", "teams" ] }, "teams": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "filter": {} }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "owner", "visibility", "teams", "filter" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "saved_filter" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "owner": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "visibility": { "type": "string", "enum": [ "private", "teams" ] }, "teams": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "filter": {} }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/saved_filters/{id}": { "get": { "operationId": "saved_filters_get", "summary": "Retrieves one team-visible saved filter.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "saved_filter" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "owner": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "visibility": { "type": "string", "enum": [ "private", "teams" ] }, "teams": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "filter": {} }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "owner", "visibility", "teams", "filter" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/task_templates": { "get": { "operationId": "task_templates_list", "summary": "Lists task templates with optional workspace and project filters.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "defaults": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "title", "description", "defaults" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "defaults": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/task_templates/{id}": { "get": { "operationId": "task_templates_get", "summary": "Retrieves one task template.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "defaults": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "title", "description", "defaults" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/task_templates/{id}/instantiate": { "post": { "operationId": "task_templates_instantiate", "summary": "Creates a task from a template with bounded field overrides.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "title": { "type": "string", "minLength": 1, "maxLength": 2000 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "workspace", "project" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/project_templates": { "get": { "operationId": "project_templates_list", "summary": "Lists project templates in visible workspaces.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "definition": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "definition" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "definition": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/project_templates/{id}": { "get": { "operationId": "project_templates_get", "summary": "Retrieves one project template.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project_template" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "definition": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "definition" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "projects:read" ], "x-ceyu-sensitive": false, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/project_templates/{id}/instantiate": { "post": { "operationId": "project_templates_instantiate", "summary": "Creates a project from a project template with an optional name override.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "workspace" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/billing_rates": { "get": { "operationId": "billing_rates_list", "summary": "Lists workspace billing rates.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "billing_rate" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "scope", "currency", "amount_minor" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "billing_rate" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "billing_rates_create", "summary": "Creates a billing rate through the operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 } }, "required": [ "workspace", "scope", "currency", "amount_minor" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "billing_rate" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "scope", "currency", "amount_minor" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/expenses": { "get": { "operationId": "expenses_list", "summary": "Lists expenses from one explicit workspace with authenticated keyset pagination.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "workspace", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] } }, { "name": "user", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "expense" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } }, "receipt": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source": { "type": "string", "enum": [ "manual", "ai_extracted" ] }, "submitted_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_by": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision_comment": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "retention_until": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "user", "project", "revision", "status", "category", "expense_date", "currency", "gross_amount_minor", "net_amount_minor", "tax_amount_minor", "tax_rate_bp", "vendor", "vendor_vat_id", "invoice_number", "payment_method", "business_purpose", "notes", "extra_fields", "receipt", "source", "submitted_at", "decided_at", "decided_by", "decision_comment", "retention_until" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "expense" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } }, "receipt": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source": { "type": "string", "enum": [ "manual", "ai_extracted" ] }, "submitted_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_by": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision_comment": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "retention_until": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "expenses_create", "summary": "Creates an idempotent draft expense and its audit event atomically.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } } }, "required": [ "workspace", "category", "expense_date", "currency", "gross_amount_minor" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "expense" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } }, "receipt": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source": { "type": "string", "enum": [ "manual", "ai_extracted" ] }, "submitted_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_by": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision_comment": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "retention_until": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "user", "project", "revision", "status", "category", "expense_date", "currency", "gross_amount_minor", "net_amount_minor", "tax_amount_minor", "tax_rate_bp", "vendor", "vendor_vat_id", "invoice_number", "payment_method", "business_purpose", "notes", "extra_fields", "receipt", "source", "submitted_at", "decided_at", "decided_by", "decision_comment", "retention_until" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/expenses/{id}": { "get": { "operationId": "expenses_get", "summary": "Retrieves one organization-scoped expense.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "expense" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } }, "receipt": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source": { "type": "string", "enum": [ "manual", "ai_extracted" ] }, "submitted_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_by": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision_comment": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "retention_until": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "user", "project", "revision", "status", "category", "expense_date", "currency", "gross_amount_minor", "net_amount_minor", "tax_amount_minor", "tax_rate_bp", "vendor", "vendor_vat_id", "invoice_number", "payment_method", "business_purpose", "notes", "extra_fields", "receipt", "source", "submitted_at", "decided_at", "decided_by", "decision_comment", "retention_until" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "expenses_update", "summary": "Updates a draft expense with compare-and-swap revision protection.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "expense" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "user": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "enum": [ "draft", "submitted", "approved", "rejected" ] }, "category": { "type": "string", "enum": [ "software", "travel", "transport", "office", "meals", "hardware", "marketing", "other" ] }, "expense_date": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "net_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_amount_minor": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tax_rate_bp": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 10000 }, { "type": "null" } ] }, "vendor": { "type": "string", "maxLength": 200 }, "vendor_vat_id": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "invoice_number": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "payment_method": { "anyOf": [ { "type": "string", "enum": [ "company_card", "private_card", "bank_transfer", "cash", "direct_debit", "paypal", "other" ] }, { "type": "null" } ] }, "business_purpose": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] }, "notes": { "type": "string", "maxLength": 2000 }, "extra_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 80 }, "additionalProperties": { "type": "string", "maxLength": 200 } }, "receipt": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source": { "type": "string", "enum": [ "manual", "ai_extracted" ] }, "submitted_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "decided_by": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "decision_comment": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "retention_until": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "user", "project", "revision", "status", "category", "expense_date", "currency", "gross_amount_minor", "net_amount_minor", "tax_amount_minor", "tax_rate_bp", "vendor", "vendor_vat_id", "invoice_number", "payment_method", "business_purpose", "notes", "extra_fields", "receipt", "source", "submitted_at", "decided_at", "decided_by", "decision_comment", "retention_until" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/exports": { "post": { "operationId": "exports_create", "summary": "Queues a bounded task export as an NDJSON artifact.", "tags": [ "exports" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resource": { "type": "string", "const": "tasks" }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "status": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "assignee": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "due_before": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "is_archived": { "type": "boolean" }, "filter": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "required": [ "resource" ], "additionalProperties": false } } } }, "responses": { "202": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "job" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "const": "export" }, "status": { "type": "string", "enum": [ "queued", "running", "succeeded", "failed" ] }, "resource": { "type": "string", "const": "tasks" }, "error_code": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "result": { "anyOf": [ { "type": "object", "properties": { "url": { "anyOf": [ { "type": "string", "maxLength": 8192, "format": "uri" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "content_type": { "type": "string", "const": "application/x-ndjson" }, "rows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "url", "expires_at", "content_type", "rows", "bytes" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "type", "status", "resource", "error_code", "result" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 500, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/jobs/{id}": { "get": { "operationId": "jobs_get", "summary": "Retrieves an export job and a fresh one-hour R2 download URL when complete.", "tags": [ "exports" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "job" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "const": "export" }, "status": { "type": "string", "enum": [ "queued", "running", "succeeded", "failed" ] }, "resource": { "type": "string", "const": "tasks" }, "error_code": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "result": { "anyOf": [ { "type": "object", "properties": { "url": { "anyOf": [ { "type": "string", "maxLength": 8192, "format": "uri" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "content_type": { "type": "string", "const": "application/x-ndjson" }, "rows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "url", "expires_at", "content_type", "rows", "bytes" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "type", "status", "resource", "error_code", "result" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "tasks:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/billing_rates/{id}": { "get": { "operationId": "billing_rates_get", "summary": "Retrieves one workspace billing rate.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "billing_rate" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "scope", "currency", "amount_minor" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "billing_rates_update", "summary": "Updates selected billing-rate fields.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "billing_rate" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "scope": { "type": "string", "minLength": 1, "maxLength": 160 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "scope", "currency", "amount_minor" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/invoice_drafts": { "get": { "operationId": "invoice_drafts_list", "summary": "Lists invoice drafts with optional workspace and project filters.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "invoice_draft" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "status", "currency", "net_amount_minor", "tax_amount_minor", "gross_amount_minor" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "invoice_draft" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "invoice_drafts_create", "summary": "Creates an invoice draft through the operation protocol.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 } }, "required": [ "workspace", "project", "currency", "net_amount_minor", "tax_amount_minor", "gross_amount_minor" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "invoice_draft" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "status", "currency", "net_amount_minor", "tax_amount_minor", "gross_amount_minor" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/invoice_drafts/{id}": { "get": { "operationId": "invoice_drafts_get", "summary": "Retrieves one invoice draft.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "invoice_draft" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "status", "currency", "net_amount_minor", "tax_amount_minor", "gross_amount_minor" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "billing:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "invoice_drafts_update", "summary": "Updates selected invoice-draft fields.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9000000000000 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "invoice_draft" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "net_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tax_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "gross_amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "status", "currency", "net_amount_minor", "tax_amount_minor", "gross_amount_minor" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "billing:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_flows": { "get": { "operationId": "automation_flows_list", "summary": "Lists automation flows with optional workspace and project filters.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "starting_after", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "ending_before", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "fields", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z][a-z0-9_]*(?:,[a-z][a-z0-9_]*)*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "automations:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "automation_flows_create", "summary": "Creates a validated automation draft through the operation protocol.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "workspace", "name", "graph" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_flows/{id}": { "get": { "operationId": "automation_flows_get", "summary": "Retrieves one automation flow.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "automations:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "automation_flows_update", "summary": "Updates a paused automation draft through the operation protocol.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_flows/{id}/preview": { "post": { "operationId": "automation_flows_preview", "summary": "Previews one automation against a task and returns a short-lived activation token.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "required": [ "workspace", "task" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^preview_[A-Za-z0-9_-]{1,180}$" }, "object": { "type": "string", "const": "automation_preview" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expires_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "automation_flow": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task_updated_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "graph_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "visited_node_ids": { "maxItems": 1000, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "effects": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "minLength": 1, "maxLength": 120 }, "label": { "type": "string", "maxLength": 500 }, "status": { "type": "string", "enum": [ "planned", "blocked", "applied", "failed" ] }, "payload": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "reason": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] } }, "required": [ "id", "kind", "label", "status", "payload", "reason" ], "additionalProperties": false } }, "blocked_effects": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "minLength": 1, "maxLength": 120 }, "label": { "type": "string", "maxLength": 500 }, "status": { "type": "string", "enum": [ "planned", "blocked", "applied", "failed" ] }, "payload": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "reason": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ] } }, "required": [ "id", "kind", "label", "status", "payload", "reason" ], "additionalProperties": false } }, "warnings": { "maxItems": 100, "type": "array", "items": { "type": "string", "maxLength": 1000 } }, "preview_token": { "type": "string", "pattern": "^auto_preview_[A-Za-z0-9-]{1,180}$" } }, "required": [ "id", "object", "created", "expires_at", "automation_flow", "task", "task_updated_at", "graph_hash", "visited_node_ids", "effects", "blocked_effects", "warnings", "preview_token" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 50, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_flows/{id}/activate": { "post": { "operationId": "automation_flows_activate", "summary": "Activates an automation only after a fresh matching preview and explicit acknowledgements.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "preview_token": { "type": "string", "pattern": "^auto_preview_[A-Za-z0-9-]{1,180}$" }, "scope_acknowledged": { "type": "boolean", "const": true }, "ai_cost_acknowledged": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "active", "observing" ] } }, "required": [ "workspace", "preview_token", "scope_acknowledged" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_flows/{id}/pause": { "post": { "operationId": "automation_flows_pause", "summary": "Pauses an automation flow with an auditable bounded reason.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "reason": { "type": "string", "enum": [ "manual", "kill_switch", "repeated_failures", "ai_credits_exhausted", "quota_exhausted" ] } }, "required": [ "workspace" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_flow" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "minLength": 1, "maxLength": 500 }, "status": { "type": "string", "enum": [ "builder", "ready", "active", "observing", "paused", "invalid" ] }, "graph": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "paused_reason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "activated_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "revision", "name", "status", "graph", "paused_reason", "activated_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_runs": { "get": { "operationId": "automation_runs_list", "summary": "Lists automation runs inside one explicitly selected workspace.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "workspace", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "automation_flow", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "task", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_run" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "automation_flow": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "trigger_event": { "type": "string", "minLength": 1, "maxLength": 200 }, "trigger_type": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": [ "queued", "running", "sleeping", "retry_pending", "applied", "conflict", "blocked", "cancelled", "failed" ] }, "attempt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resume_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "origin_run": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "depth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "last_error_code": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "last_error_message": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "cancelled_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "wait_kind": { "anyOf": [ { "type": "string", "enum": [ "duration", "breakpoint" ] }, { "type": "null" } ] }, "breakpoint_node_id": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "automation_flow", "task", "trigger_event", "trigger_type", "status", "attempt", "resume_at", "origin_run", "depth", "last_error_code", "last_error_message", "cancelled_at", "wait_kind", "breakpoint_node_id" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_run" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "automation_flow": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "trigger_event": { "type": "string", "minLength": 1, "maxLength": 200 }, "trigger_type": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": [ "queued", "running", "sleeping", "retry_pending", "applied", "conflict", "blocked", "cancelled", "failed" ] }, "attempt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resume_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "origin_run": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "depth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "last_error_code": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "last_error_message": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "cancelled_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "wait_kind": { "anyOf": [ { "type": "string", "enum": [ "duration", "breakpoint" ] }, { "type": "null" } ] }, "breakpoint_node_id": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "automations:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_runs/{id}": { "get": { "operationId": "automation_runs_get", "summary": "Retrieves one automation run and bounded audit metadata.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_run" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "automation_flow": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "trigger_event": { "type": "string", "minLength": 1, "maxLength": 200 }, "trigger_type": { "type": "string", "minLength": 1, "maxLength": 120 }, "status": { "type": "string", "enum": [ "queued", "running", "sleeping", "retry_pending", "applied", "conflict", "blocked", "cancelled", "failed" ] }, "attempt": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "resume_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "origin_run": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "depth": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "last_error_code": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "last_error_message": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "cancelled_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "wait_kind": { "anyOf": [ { "type": "string", "enum": [ "duration", "breakpoint" ] }, { "type": "null" } ] }, "breakpoint_node_id": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "audits": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "undone_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "undo_run": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "required": [ "id", "status", "created", "undone_at", "undo_run" ], "additionalProperties": false } } }, "required": [ "id", "object", "created", "updated", "workspace", "automation_flow", "task", "trigger_event", "trigger_type", "status", "attempt", "resume_at", "origin_run", "depth", "last_error_code", "last_error_message", "cancelled_at", "wait_kind", "breakpoint_node_id", "audits" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "automations:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/automation_runs/{id}/cancel": { "post": { "operationId": "automation_runs_cancel", "summary": "Cancels a queued, running, sleeping, or retrying automation run.", "tags": [ "automations" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, "required": [ "workspace" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "automation_run" }, "status": { "type": "string", "const": "cancelled" }, "cancelled_at": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "object", "status", "cancelled_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "automations:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/projects/{id}/archive": { "post": { "operationId": "projects_archive", "summary": "Archives a project while preserving its synchronized history.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/projects/{id}/duplicate": { "post": { "operationId": "projects_duplicate", "summary": "Atomically duplicates a project with up to 99 columns and tasks.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 500 } }, "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 25, "x-ceyu-required-scopes": [ "projects:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/batch": { "post": { "operationId": "tasks_batch_create", "summary": "Creates up to 100 tasks in one serialized FlowTask commit.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "data": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "title": { "type": "string", "minLength": 1, "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} } }, "required": [ "title" ], "additionalProperties": false } } }, "required": [ "workspace", "data" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 25, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{id}/complete": { "post": { "operationId": "tasks_complete", "summary": "Marks a task done and records its completion time.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{id}/move": { "post": { "operationId": "tasks_move", "summary": "Moves a task to another project or compatible column atomically.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "task" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "column": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "maxLength": 2000 }, "description": { "type": "string", "maxLength": 100000 }, "status": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "string", "minLength": 1, "maxLength": 120 }, "assignee": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "labels": { "maxItems": 200, "type": "array", "items": { "type": "string", "maxLength": 240 } }, "custom_fields": { "type": "object", "propertyNames": { "type": "string", "maxLength": 240 }, "additionalProperties": {} }, "project_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "project" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "name": { "type": "string", "maxLength": 500 }, "description": { "type": "string", "maxLength": 50000 }, "portfolio": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "archived_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "updated", "workspace", "revision", "name", "description", "portfolio", "archived_at" ], "additionalProperties": false }, "assignee_expanded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "user" } }, "required": [ "id", "object" ], "additionalProperties": false } }, "required": [ "id", "object", "created", "updated", "workspace", "project", "column", "revision", "title", "description", "status", "priority", "assignee", "due_at", "completed_at", "labels", "custom_fields" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/tasks/{task_id}/dependencies/{id}": { "delete": { "operationId": "task_dependencies_delete", "summary": "Removes an outgoing task dependency.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "enum": [ "portfolio", "project", "column", "task", "comment", "dependency", "time_entry" ] }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "tasks:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/time_entries/start": { "post": { "operationId": "time_entries_start", "summary": "Starts a time entry using the server clock.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 31536000000 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "workspace", "task" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "time_entries:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/time_entries/{id}/stop": { "post": { "operationId": "time_entries_stop", "summary": "Stops a running time entry and computes its duration from the server clock.", "tags": [ "flowtask" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } }, { "name": "workspace", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "time_entry" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "workspace": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "task": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "project": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "revision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "user": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "note": { "type": "string", "maxLength": 100000 }, "billable": { "type": "boolean" } }, "required": [ "id", "object", "created", "updated", "workspace", "task", "project", "revision", "user", "started_at", "ended_at", "duration_ms", "note", "billable" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "time_entries:write" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/webhook_endpoints": { "get": { "operationId": "webhook_endpoints_list", "summary": "Lists webhook destinations configured for this organization.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] } }, "required": [ "id", "object", "created", "updated", "url", "event_types", "exclude_own_events", "status" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "post": { "operationId": "webhook_endpoints_create", "summary": "Creates a webhook destination and returns its secret once.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" } }, "required": [ "url", "event_types" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] }, "secret": { "type": "string", "pattern": "^whsec_[A-Za-z0-9_-]{43}$" } }, "required": [ "id", "object", "created", "updated", "url", "event_types", "exclude_own_events", "status", "secret" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "422": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "invalid_webhook_url", "webhook_target_unavailable", "webhook_verification_failed", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/webhook_endpoints/{id}": { "get": { "operationId": "webhook_endpoints_get", "summary": "Retrieves a webhook destination without exposing its secret.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] } }, "required": [ "id", "object", "created", "updated", "url", "event_types", "exclude_own_events", "status" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "patch": { "operationId": "webhook_endpoints_update", "summary": "Updates a webhook URL, subscriptions, or delivery state.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled" ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] } }, "required": [ "id", "object", "created", "updated", "url", "event_types", "exclude_own_events", "status" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "422": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "invalid_webhook_url", "webhook_target_unavailable", "webhook_verification_failed", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] }, "delete": { "operationId": "webhook_endpoints_delete", "summary": "Permanently removes a webhook destination.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "deleted": { "type": "boolean", "const": true } }, "required": [ "id", "object", "deleted" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "422": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "invalid_webhook_url", "webhook_target_unavailable", "webhook_verification_failed", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/webhook_endpoints/{id}/rotate_secret": { "post": { "operationId": "webhook_endpoints_rotate_secret", "summary": "Rotates a webhook signing secret with a 24-hour overlap.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_endpoint" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "updated": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "url": { "type": "string", "maxLength": 2048, "format": "uri" }, "event_types": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } }, "exclude_own_events": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "disabled", "unverified" ] }, "secret": { "type": "string", "pattern": "^whsec_[A-Za-z0-9_-]{43}$" } }, "required": [ "id", "object", "created", "updated", "url", "event_types", "exclude_own_events", "status", "secret" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "422": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "invalid_webhook_url", "webhook_target_unavailable", "webhook_verification_failed", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/events": { "get": { "operationId": "events_list", "summary": "Lists retained webhook events for troubleshooting and replay.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": {} }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "event" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "workspace": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source_revision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "triggered_by": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "user", "api_key", "application" ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "type", "api_version", "workspace", "source_revision", "triggered_by", "data" ], "additionalProperties": false } } }, "required": [ "object", "url", "has_more", "next_cursor", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "object": { "type": "string", "const": "list" }, "url": { "type": "string", "pattern": "^\\/v1\\/.*" }, "has_more": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "data": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "event" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "workspace": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source_revision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "triggered_by": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "user", "api_key", "application" ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "additionalProperties": false } }, "fields_selected": { "type": "boolean", "const": true } }, "required": [ "object", "url", "has_more", "next_cursor", "data", "fields_selected" ], "additionalProperties": false } ] } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "cursor_invalid", "cursor_filter_mismatch", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/events/stream": { "get": { "operationId": "events_stream", "summary": "Streams new organization events over resumable Server-Sent Events.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "types[]", "in": "query", "required": true, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] } } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "text/event-stream": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 5, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/events/{id}": { "get": { "operationId": "events_get", "summary": "Retrieves an event with every bounded webhook delivery attempt.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "event" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "workspace": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source_revision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "triggered_by": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "user", "api_key", "application" ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "deliveries": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "webhook_delivery" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "endpoint": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "attempt": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "status_code": { "anyOf": [ { "type": "integer", "minimum": 100, "maximum": 599 }, { "type": "null" } ] }, "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "response_excerpt": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ] }, "error_code": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "id", "object", "created", "endpoint", "attempt", "status_code", "duration_ms", "response_excerpt", "error_code" ], "additionalProperties": false } } }, "required": [ "id", "object", "created", "type", "api_version", "workspace", "source_revision", "triggered_by", "data", "deliveries" ], "additionalProperties": false } } } }, "304": { "description": "Not modified; the supplied ETag still matches.", "headers": { "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string" } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 1, "x-ceyu-required-scopes": [ "api:read" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": false, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/events/{id}/resend": { "post": { "operationId": "events_resend", "summary": "Schedules a fresh delivery cycle for one retained webhook event.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "event" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "workspace": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source_revision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "triggered_by": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "user", "api_key", "application" ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "type", "api_version", "workspace", "source_revision", "triggered_by", "data" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } }, "/v1/events/{id}/replay": { "post": { "operationId": "events_replay", "summary": "Starts a new delivery cycle for a retained webhook event.", "tags": [ "webhooks" ], "security": [ { "bearerCredential": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" } } ], "responses": { "200": { "description": "Successful response", "headers": { "Ceyu-Version": { "schema": { "type": "string" } }, "X-RateLimit-Cost": { "schema": { "type": "integer", "minimum": 1 } }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, "object": { "type": "string", "const": "event" }, "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "type": { "type": "string", "enum": [ "flowtask.task.created", "flowtask.task.updated", "flowtask.task.completed", "flowtask.task.deleted", "flowtask.task.assigned", "flowtask.task.moved", "flowtask.project.created", "flowtask.project.updated", "flowtask.project.archived", "flowtask.project.status_changed", "flowtask.comment.created", "flowtask.comment.mentioned", "flowtask.time_entry.started", "flowtask.time_entry.stopped", "flowtask.dependency.created", "flowtask.dependency.removed", "flowtask.automation_run.succeeded", "flowtask.automation_run.failed", "whiteboard.board.created", "whiteboard.board.updated", "whiteboard.board.deleted", "whiteboard.board.shared", "whiteboard.board.member_added", "whiteboard.board.member_removed", "whiteboard.export.completed", "whiteboard.export.failed", "suite.member.invited", "suite.member.joined", "suite.member.removed", "suite.member.role_changed", "platform.api_key.created", "platform.api_key.revoked", "platform.webhook_endpoint.disabled" ] }, "api_version": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "workspace": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$" }, { "type": "null" } ] }, "source_revision": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "triggered_by": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "user", "api_key", "application" ] }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "id", "object", "created", "type", "api_version", "workspace", "source_revision", "triggered_by", "data" ], "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "402": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } }, "503": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "x-ceyu-api-version": "2026-08-03", "x-ceyu-credit-cost": 10, "x-ceyu-required-scopes": [ "api:manage" ], "x-ceyu-sensitive": true, "x-ceyu-idempotency-required": true, "x-ceyu-error-codes": [ "missing_api_key", "invalid_api_key", "invalid_access_token", "credential_validation_unavailable", "insufficient_scope", "plan_required", "invalid_query_parameter", "resource_not_found", "resource_deleted", "resource_id_ambiguous", "invalid_request_body", "idempotency_key_required", "invalid_idempotency_key", "idempotency_key_reused", "idempotency_in_progress", "resource_conflict", "endpoint_disabled", "rate_limit_exceeded", "rate_limit_unavailable", "internal_error" ] } } }, "components": { "securitySchemes": { "bearerCredential": { "type": "http", "scheme": "bearer", "bearerFormat": "WorkOS API key or WorkOS Connect M2M JWT" } }, "schemas": { "PublicApiError": { "type": "object", "properties": { "error": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "invalid_request_error", "authentication_error", "authorization_error", "rate_limit_error", "api_error" ] }, "code": { "type": "string", "minLength": 1, "maxLength": 120 }, "message": { "type": "string", "minLength": 1, "maxLength": 2000 }, "param": { "anyOf": [ { "type": "string", "maxLength": 240 }, { "type": "null" } ] }, "doc_url": { "type": "string", "format": "uri" }, "request_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "details": {} }, "required": [ "type", "code", "message", "request_id" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } }, "x-ceyu-error-catalog": { "api_key_in_query": "API keys must be sent in the Authorization header.", "missing_api_key": "The Authorization header is required.", "invalid_api_key": "The supplied API key is invalid or expired.", "api_key_revoked": "The supplied API key has been revoked.", "api_key_validation_unavailable": "A new API key cannot be validated right now.", "invalid_access_token": "The supplied M2M access token is invalid or expired.", "credential_validation_unavailable": "The credential cannot be validated right now.", "insufficient_scope": "The API key does not grant the required scope.", "plan_required": "The organization plan does not include the public API.", "endpoint_disabled": "This endpoint group is temporarily unavailable.", "endpoint_not_found": "No public API endpoint matches the request.", "invalid_request_body": "The request body does not match the endpoint schema.", "invalid_query_parameter": "A query parameter is invalid.", "invalid_webhook_url": "The webhook URL must be a public HTTPS address.", "webhook_target_unavailable": "The webhook target could not be resolved safely right now.", "webhook_verification_failed": "The webhook target did not accept the signed verification event.", "cursor_invalid": "The pagination cursor is invalid.", "cursor_filter_mismatch": "The cursor belongs to a different filter or sort.", "unsupported_filter": "The filter contains an unsupported field, operator, or structure.", "resource_not_found": "The resource does not exist or is not visible to this key.", "resource_id_ambiguous": "The resource id is not unique; provide its workspace filter.", "resource_deleted": "The resource was deleted and its tombstone is still retained.", "resource_conflict": "The resource changed after the version supplied by the caller.", "idempotency_key_required": "This request requires an Idempotency-Key header.", "invalid_idempotency_key": "The Idempotency-Key header is malformed.", "idempotency_key_reused": "The idempotency key was already used for another request.", "idempotency_in_progress": "A request with this idempotency key is still running.", "rate_limit_exceeded": "The API credit limit has been reached.", "rate_limit_unavailable": "API credit accounting is temporarily unavailable.", "internal_error": "The request could not be completed due to an internal error." } }