{ "openapi": "3.1.0", "info": { "title": "Juno qualified developer API", "version": "1.1.0", "description": "Generated from the schemas used by Juno handlers and key-management UI. Only listed operations are supported. Explicit automation grants expose canonical reports, skills, AI requests/tool runs, finite preparation, media plans, result suggestions, reviewed queue fill and social workflows. Every consequential action retains current finite consent, exact media/account identity, original command and recovery safeguards." }, "components": { "securitySchemes": { "session": { "type": "http", "scheme": "bearer", "description": "Owner session for the listed owner key-management operations only; it is not delegated OAuth admission." }, "agentOAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Locally qualified registered-client bearer for one fixed Juno API resource. Policy v1 admits capability/account-directory GETs only. Fresh explicit policy v2 registration and owner binding admit additionally scoped single-target unscheduled Threads plain-text preparation. Exact cryptographic/current client, binding, grant, issuer, audience, subject, expiry, ownership and deletion checks apply. Fresh explicit policy v3 registration and exact selected-tool owner consent admit only current same-grant management actions/targets, with original-client command namespace and downstream withdrawal guards. Older policies do not gain permissions. No generic application JWT, cross-resource MCP bearer or raw database/Storage access. Live issuer/consent/client activation is a separately observed state." }, "apiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "schemas": {}, "parameters": {} }, "paths": { "/api/v1/documentation": { "get": { "operationId": "readPublicDocumentation", "security": [], "description": "Anonymous immutable public documentation only. No account data, credentials, provider calls, execution or arbitrary URL/file retrieval. view defaults to list. list/search accept limit (1–20, default20) and a catalog-version/query/limit-bound cursor. search requires literal q (trimmed1–160); read requires the exact public document id and forbids paging/search inputs. Unknown or view-incompatible fields are rejected. A stale cursor requires restarting traversal. Public documents describe locally qualified behavior and explicitly retain hosted/provider/client gaps.", "parameters": [ { "schema": { "type": "string", "enum": [ "list", "read", "search" ], "default": "list" }, "required": false, "name": "view", "in": "query" }, { "schema": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,99}$" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "q", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 20 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 1024 }, "required": false, "name": "cursor", "in": "query" } ], "responses": { "200": { "description": "Current public document or metadata page", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "documents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,99}$" }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "guide", "operation" ] }, "summary": { "type": "string", "maxLength": 2048 }, "url": { "type": "string", "pattern": "^\\/developer\\/(guides|operations)\\/[a-z][a-z0-9-]{0,99}\\.md$" }, "operation_id": { "type": [ "string", "null" ], "maxLength": 160 }, "method": { "type": [ "string", "null" ], "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", null ] }, "path": { "type": [ "string", "null" ], "maxLength": 200 } }, "required": [ "id", "title", "kind", "summary", "url", "operation_id", "method", "path" ], "additionalProperties": false }, "maxItems": 20 }, "next_cursor": { "type": [ "string", "null" ], "maxLength": 1024 } }, "required": [ "success", "version", "documents", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "version": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "document": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,99}$" }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "guide", "operation" ] }, "summary": { "type": "string", "maxLength": 2048 }, "url": { "type": "string", "pattern": "^\\/developer\\/(guides|operations)\\/[a-z][a-z0-9-]{0,99}\\.md$" }, "operation_id": { "type": [ "string", "null" ], "maxLength": 160 }, "method": { "type": [ "string", "null" ], "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", null ] }, "path": { "type": [ "string", "null" ], "maxLength": 200 }, "markdown": { "type": "string", "minLength": 1, "maxLength": 65536 } }, "required": [ "id", "title", "kind", "summary", "url", "operation_id", "method", "path", "markdown" ], "additionalProperties": false } }, "required": [ "success", "version", "document" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid query, missing public document, unsupported method or documentation unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "Invalid query, missing public document, unsupported method or documentation unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "Invalid query, missing public document, unsupported method or documentation unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "Invalid query, missing public document, unsupported method or documentation unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/retry-failed-posts": { "post": { "operationId": "retryFailedPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Explicit posts:retry admission, posts:read for bounded failed-candidate reads. Only original agent-admitted owner-approved plain Threads or separately qualified registered root-media deliveries with canonical definite pre-effect failures, exact unchanged certified assets and no provider operation across every attempt; chains/interactions and other providers remain outside retry admission; maximum three normal publication attempts. Confirm exact original delivery UUID and failed attempt number. All selected targets admit or none. Both current original delivery authority and separately granted retry authority remain required through normal jobs and each provider write. Unknown effects, generic failures, exhausted or consumed attempts remain held. Immutable control UUID and input recover without dispatch again using delivery-control-command. No automatic write retry, provider refresh, deletion or in-flight cancellation. Candidate pages inspect at most limit rows; an empty page can have next_after. This is pipeline admission, not confirmed publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "expected_attempt_number": { "type": "integer", "minimum": 1, "maximum": 2 } }, "required": [ "post_id", "delivery_command_id", "expected_attempt_number" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "confirm", "workspaceId", "posts" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Qualified failed candidates or immutable retry admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:retry" ] }, "admission": { "type": "string", "enum": [ "retry_scheduled" ] }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:retry" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:retry" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "delivery_grant_id": { "type": "string", "format": "uuid" }, "previous_scheduled_for": { "type": [ "string", "null" ] }, "scheduled_for": { "type": "string" }, "failed_attempt_number": { "type": "integer", "minimum": 1, "maximum": 2 } }, "required": [ "provider", "account_id", "post_id", "delivery_command_id", "delivery_grant_id", "previous_scheduled_for", "scheduled_for", "failed_attempt_number" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "input_hash", "audit_id", "created_at", "action", "admission", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "success", "receipt", "recovered" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/delivery-retry-candidates": { "get": { "operationId": "readRetryCandidates", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Explicit posts:retry admission, posts:read for bounded failed-candidate reads. Only original agent-admitted owner-approved plain Threads or separately qualified registered root-media deliveries with canonical definite pre-effect failures, exact unchanged certified assets and no provider operation across every attempt; chains/interactions and other providers remain outside retry admission; maximum three normal publication attempts. Confirm exact original delivery UUID and failed attempt number. All selected targets admit or none. Both current original delivery authority and separately granted retry authority remain required through normal jobs and each provider write. Unknown effects, generic failures, exhausted or consumed attempts remain held. Immutable control UUID and input recover without dispatch again using delivery-control-command. No automatic write retry, provider refresh, deletion or in-flight cancellation. Candidate pages inspect at most limit rows; an empty page can have next_after. This is pipeline admission, not confirmed publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "after", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Qualified failed candidates or immutable retry admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "expected_attempt_number": { "type": "integer", "minimum": 1, "maximum": 2 } }, "required": [ "provider", "account_id", "post_id", "delivery_command_id", "expected_attempt_number" ] } }, "next_after": { "type": [ "string", "null" ] } }, "required": [ "success", "posts", "next_after" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/delivery-chain": { "get": { "operationId": "readDeliveryChain", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Read the existing ordered Threads chain journal for an exact post from the original delivery UUID and grant. Current posts:read and target ownership required before and after reading; no provider calls or mutation. Pending, partial, unknown, rejected and complete states retain nullable actual provider receipts. A root provider ID alone does not prove a complete chain. Confirmed segments are not resent. Deleted posts return unavailable; original delivery-command recovery still returns nullable outcomes. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "post_id", "in": "query" } ], "responses": { "200": { "description": "Current stored ordered segment outcomes", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "chain": { "type": "object", "properties": { "found": { "type": "boolean" }, "complete": { "type": "boolean" }, "status": { "type": "string", "enum": [ "pending", "unavailable", "published", "unconfirmed", "rejected", "partial" ] }, "canResume": { "type": "boolean" }, "reason": { "type": [ "string", "null" ] }, "operationId": { "type": [ "string", "null" ] }, "segments": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "text": { "type": "string" }, "providerText": { "type": [ "string", "null" ] }, "parentThreadId": { "type": [ "string", "null" ] }, "containerId": { "type": [ "string", "null" ] }, "threadId": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "pending", "creating", "created", "publishing", "confirmed", "rejected", "unknown" ] }, "publishedAt": { "type": [ "string", "null" ] }, "confirmedAt": { "type": [ "string", "null" ] } }, "required": [ "index", "text", "providerText", "parentThreadId", "containerId", "threadId", "state", "publishedAt", "confirmedAt" ] }, "maxItems": 101 } }, "required": [ "found", "complete", "status", "canResume", "reason", "operationId", "segments" ], "additionalProperties": false } }, "required": [ "success", "post_id", "delivery_command_id", "chain" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/publish-native-draft": { "post": { "operationId": "publishNativeDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Publish one exact stored native draft revision as an Instagram Reel on one explicitly granted account without per-post human review. Requires separate posts:publish-unreviewed, posts:publish, posts:read and native-drafts:read plus current native Instagram/video/media permissions on the same finite grant. Existing grants gain no action automatically. The server preserves immutable native/source revisions and exact certified assigned bytes and repeats current authority before effects. Other providers/formats stay held. Retain command_id before calling. Admission scheduled is not publication. Recover unknown acknowledgement with autonomous-post-command for the original UUID; never automatically resend POST or replace it. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "draft_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "minimum": 0 }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "workspaceId", "command_id", "confirm", "draft_id", "expected_revision", "account_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Immutable autonomous authorization and immediate delivery admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "scheduled_for": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "fingerprint" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "action", "scheduled_for", "input_hash", "audit_id", "created_at", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "admission": { "type": "string", "enum": [ "scheduled" ] }, "authorization": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "authorization_id": { "type": "string", "format": "uuid" }, "request_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "origin": { "type": "string", "enum": [ "agent_autonomous" ] }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "expires_at": { "type": "string", "format": "date-time" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] } }, "required": [ "type", "credential_type", "grant_id", "action" ], "additionalProperties": {} }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": {} } ] } }, "required": [ "command_id", "authorization_id", "request_id", "post_id", "workspace_id", "grant_id", "origin", "action", "fingerprint", "input_hash", "expires_at", "delegated_actor" ], "additionalProperties": {} } }, "required": [ "success", "receipt", "recovered", "admission" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/autonomous-post-command": { "get": { "operationId": "readAutonomousPostCommand", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Read original autonomous authorization and nullable delivery outcome with posts:read and the original grant/client namespace. No provider call, mutation, replay or replacement command. Admission is not publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Original authorization and nullable delivery outcome", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "authorization": { "type": [ "object", "null" ], "properties": { "command_id": { "type": "string", "format": "uuid" }, "authorization_id": { "type": "string", "format": "uuid" }, "request_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "origin": { "type": "string", "enum": [ "agent_autonomous" ] }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "expires_at": { "type": "string", "format": "date-time" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] } }, "required": [ "type", "credential_type", "grant_id", "action" ], "additionalProperties": {} }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:publish-unreviewed" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": {} } ] } }, "required": [ "command_id", "authorization_id", "request_id", "post_id", "workspace_id", "grant_id", "origin", "action", "fingerprint", "input_hash", "expires_at", "delegated_actor" ], "additionalProperties": {} }, "delivery": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "scheduled_for": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "fingerprint" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "action", "scheduled_for", "input_hash", "audit_id", "created_at", "delegated_actor", "posts" ], "additionalProperties": false }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "status": { "type": [ "string", "null" ] }, "scheduled_for": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "provider_post_id": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." } }, "required": [ "provider", "account_id", "post_id", "status", "scheduled_for", "published_at", "provider_post_id", "reason" ] } } }, "required": [ "success", "receipt", "posts" ] }, "authorization_current": { "type": "boolean" }, "authorization_reason": { "type": [ "string", "null" ] } }, "required": [ "success", "authorization" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/publish-approved-posts": { "post": { "operationId": "publishApprovedPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Reviewed Facebook feed video and Reels, X video and Bluesky video require independent posts:facebook-video, posts:facebook-reels, posts:x-video or posts:bluesky-video, plus the base provider, posts:media, posts:read and requested publish/schedule permission on the same current finite grant and exact target. Existing grants gain no authority. Each binds one assigned current fully certified original asset, SHA-256 and Storage version. Facebook VIDEO uses delivery_format=facebook.approved-video.v1 and format=registered_video; REELS uses facebook.approved-reels.v1 and registered_reel. Facebook H264 MP4/MOV supports up to 4 GiB, feed 1 second–4 hours; Reels 3–90 seconds with actual constant 24–60 fps, minimum 540x960 and display ratio 9:16–16:9, original compliant audio. No video alt or unqualified options. X uses x.approved-video.v1 and registered_media: H264 MP4 up to 8 GiB, 0.5–1200 seconds, square pixels, 32px minimum, short side at most 1024/long side 1280, ratio 1:3–3:1, at most 60 fps and original AAC-LC mono/stereo or silence. Historical certificates lacking actual square-pixel/audio/segment evidence require revalidation; no replacement audio, cover or alt. Bluesky uses bluesky.approved-video.v1 and registered_media: one H264 MP4 up to 300,000,000 bytes and ten minutes; optional exact untrimmed description up to 2000 Unicode code points, default empty; caption at most 300 graphemes/3000 UTF-8 bytes. Native account quota remains required. Upload completion is not certification: native uploads remain pending until complete original-byte decoding, SHA and segment proofs finish. Original owner review/source, grant, account/session, command, certificate and current authority are repeated at execution and recovery. Acknowledged progress resumes only in the original attempt; uncertain writes stay held and recover by exact original native readback, never replacement command or resend. Admission/processing is not confirmed publication. Workspace quotas remain separate from native limits.\n\nApproved delivery accepts existing currently editorial-approved posts only. Reads require posts:read; each write requires its requested posts:schedule or posts:publish action, exact destination, provider opt-in and every selected format opt-in on one current named grant. Preparation, ordinary API keys, OAuth bindings and broad media permission do not supply these independent consents. Existing grants gain no new format. Every selected post must pass normal content preflight; the batch admits all targets or none, with one post per account. Registered media binds original ordered IDs, SHA-256, owner/workspace/account assignment, exact bytes, current certificate and immutable storage-object version; arbitrary stored or caller URLs are not evidence.\n\nThreads: plain text; text chains require posts:chains; registered root media requires posts:media; registered per-segment media chains require posts:media-chains plus posts:chains and posts:media, at most one certified asset per segment and 20 distinct assets per chain. Root-media certificate/count/byte rules remain independent from chain rules. Polls require posts:threads-polls (threads.approved-poll.v1); stored-parent replies require posts:threads-replies (threads.approved-reply.v1); stored-parent quotes require posts:threads-quotes (threads.approved-quote.v1); compound interaction chains require posts:threads-interaction-chains plus posts:chains and each applicable root poll/reply/quote opt-in (threads.approved-interaction-chain.v1). Interactions are plaintext only, with 2–4 ordered poll choices (at most 25 characters each), at most 500 UTF-8 bytes per segment, and existing one-root/100-reply capacity. Reply/quote parents must be exact-account stored published posts or qualified inbox reply/mention selectors; bare external IDs cannot substitute for provenance. Reply and quote are exclusive. Media and other active incompatible options remain held for these interaction descriptors.\n\nBluesky single image requires posts:bluesky-images plus posts:bluesky/posts:media/posts:read and the write action: one certified JPEG/PNG/WebP up to 2,000,000 bytes, nonempty already-trimmed approved alt up to 2000 characters, native caption at most 300 graphemes/3000 UTF-8 bytes. Reviewed Bluesky multiple images require independent posts:bluesky-multiple-images plus posts:bluesky, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact native account. Existing plaintext and posts:bluesky-images single-image grants gain no multiple-image permission. Bound 2–4 ordered current certified assigned immutable Library JPEG/PNG/WebP images, each at most 2,000,000 bytes with positive integer dimensions. Caption may be empty, otherwise at most 300 graphemes and 3,000 UTF-8 bytes. Each reviewed alt must be nonempty, already trimmed and at most 2000 Unicode code points, preserved exactly. Candidates and receipts retain delivery_format=bluesky.approved-multiple-images.v1, existing format=registered_media and ordered media_refs (id,sha256,alt_text). Original source/review, native DID/session/revision/scopes, certified object versions, command and attempt remain bound. Unknown uploads or record creation hold without writer replay; only positively unsent progress within the original lease or exact original known-record GET readback may recover under current authority. Plaintext and the established one-image helper and permission retain their limits and ABI. No galleries, video, other embeds, replies, quotes, chains, delegated retry or legacy OAuth v1/v2 delivery.\n\nReviewed X images require independent posts:x-images plus posts:x, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact X account. Existing plaintext grants gain no image permission. Bound 1–4 ordered current certified assigned immutable Library JPEG/PNG images, each at most 5,000,000 exact bytes with positive integer dimensions, and exact untrimmed per-image alt text at most 1000 Unicode characters. Caption may be empty; otherwise the native weighted parser must accept at most 280 characters and one cashtag. Candidates/receipts retain delivery_format=x.approved-images.v1, existing format=registered_media, and ordered media_refs (id,sha256,alt_text). Original source/review, native account instance/subject/credential, object versions, command and attempt remain bound. Unknown upload/metadata/publication effects hold without writer replay; only original acknowledged progress or known-post GET readback may recover under current authority. No image-path credential refresh, first comments, replies, quotes, chains, GIF/WebP/video/audio, delegated retry, legacy OAuth v1/v2 delivery or provider-entitlement expansion.\n\nReviewed LinkedIn member/organization images require independent posts:linkedin-images plus posts:linkedin, posts:media, posts:read and the requested schedule/publish action on the same current grant; existing plaintext grants gain no image permission. Bound 1–20 ordered certified assigned immutable Library JPEG/PNG images, each at most 10,000,000 bytes and fewer than 36,152,320 pixels, exact nonempty commentary at most 3000 string units, and reviewed per-image alt text at most 4086 Unicode characters. Only PUBLIC visibility and MAIN_FEED distribution with empty targeting/channels, PUBLISHED lifecycle and reshare-disabled=false qualify. Candidates/receipts preserve delivery_format=linkedin.approved-images.v1 and exact ordered media_refs (id,sha256,alt_text). Original destination/connection/member/subject/author/credential, review, object versions and attempt remain mandatory. Unknown initialization or publication holds without replay; unknown byte upload permits only exact original image-URN readiness GET. Positively unsent progress needs the original lease; known post URNs permit exact original GET readback. Unavailable read/permission proof remains unavailable. The image path does not refresh tokens or authorize video/document/GIF, replies/chains/retry or legacy OAuth v1/v2 delivery; video and PDF use the separate permissions and paths below.\n\nReviewed Facebook Page plaintext requires posts:facebook; 1–10 assigned certified immutable Library JPEG/PNG images (each at most 10,000,000 bytes) additionally require independent posts:facebook-images and posts:media on the same posts:read and schedule/publish grant. Ordered exact asset IDs, SHA-256, storage versions and reviewed per-image alt text (at most 1000 characters) remain bound to the original Page credential, approved source and original attempt. Image-only caption may be empty. Original acknowledged photo IDs are published in approved order; unknown upload/publication effects hold without replay. Only positively unsent original-lease progress or exact known-post GET readback may recover. Facebook video, chains, delegated retry and legacy OAuth v1/v2 delivery remain held.\n\nReviewed Instagram Reels require independent posts:instagram-video; reviewed JPEG carousels require independent posts:instagram-carousel. Each also requires posts:instagram, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact account. Descriptors are instagram.approved-video.v1 and instagram.approved-carousel.v1 with existing format=registered_media and exact ordered media_refs. Reels bind one certified assigned MP4/H264 up to 300,000,000 bytes and 3–900 seconds with actual decoded frame/audio/layout evidence, exact embedded original audio, separately certified JPEG cover or original frame offset, and reviewed share_to_feed/audio_name/is_ai_generated options. Carousels bind 2–10 distinct certified assigned JPEGs up to 8,000,000 bytes each, aspect 0.8–1.91 and untrimmed alt text up to 1000 Unicode code points. Empty media captions are valid; normal Juno caption limit remains 2200 UTF-16 units. Both login modes require the original current native subject/creation identity, selected direct or Page credential, finite scopes/expiry, source/review, certificate/object version, command and attempt. Unknown child/parent/publish writes hold without resend; recovery uses original protected inputs, positively unsent progress or exact known-container/media GET, never replacement URLs, refresh or guessed IDs. Requested unavailable observable proof holds. Existing single-JPEG grants gain no P2 permission.\n\nReviewed Instagram caption plus one assigned certified Library JPEG requires independent posts:instagram and posts:media on the same posts:read/schedule-or-publish grant, exact original native login/subject/Page credential and certified object version, original attempt only. Unknown create/publish effects hold without resend; only original known-container progress or exact known-media readback may recover. The single-JPEG permission does not authorize Reels, carousels or Stories; those require the separate opt-ins described here. Caption-only, PNG, replies/chains/retry/legacy OAuth v1/v2 delivery and nonempty unqualified alt/native metadata remain outside this single-JPEG path.\n\nLinkedIn video/PDF: independent posts:linkedin-video or posts:linkedin-document, plus posts:linkedin/posts:media/posts:read and the requested write action. Descriptors linkedin.approved-video.v1 and linkedin.approved-document.v1 bind one original asset and explicit native title/options. Video is certified full-decoded H264 MP4, 75,000–500,000,000 bytes and 3–1800 seconds, preserving original embedded audio and ordered original multipart ranges; optional selected distinct JPEG/PNG cover is separately certified and at most 10 MB. Document is certified unencrypted PDF up to 100,000,000 bytes with a valid bounded 1–300-page tree, explicit title and no cover. Title is 1–400 Unicode characters, separate from commentary. Exact current member/organization destination, native revision/scopes/credential, approved source and original operation remain required. Unknown initialization/publication holds without replay; known original upload/URN progress and exact original readback recover only within the qualified native protocol. Media recovery introduces no credential refresh.\n\nPinterest: posts:pinterest plus independent posts:pinterest-images or posts:pinterest-video, posts:media/posts:read and the write action. Descriptors pinterest.approved-images.v1 and pinterest.approved-video.v1 target the explicitly selected acknowledged local/native board, never an arbitrary first board. PUBLIC or SECRET boards need matching acknowledged ownership; PROTECTED or unproven shared boards hold. Image is one certified JPEG/PNG; video is original certified H264 MP4 plus a separately selected JPEG/PNG cover in reviewed order. Juno bounds each asset to 10,000,000 bytes; video is at least 75,000 bytes and 4–300 seconds. Title, description, required Pin accessibility text, optional HTTPS destination and selected AI disclosure remain exact. media_refs include id,sha256,role,mime_type,file_size,alt_text. Registration/upload/create are original irreversible phases; unknown registration or Pin create without an ID holds. Known registered-media processing and known Pin readback use only the original IDs; no new upload, signed URL or attempt is inferred. Delegated access needs more than 60 seconds of current cached lifetime and is not refreshed.\n\nYouTube: posts:youtube/posts:media/posts:read and the write action. Descriptors youtube.approved-video.v1 and youtube.approved-shorts.v1 bind one original fully decoded H264 MP4, AAC or silent audio, up to 500 MB and 0.5–900 seconds. Shorts eligibility additionally needs square/portrait geometry and at most 180 seconds; it does not establish native Shorts classification. Explicit title, description, tags, category, requested privacy, made-for-kids, synthetic-media disclosure, subscriber notification, delivery_format and consent version youtube-certified-video-20261002-v1 remain reviewed. Required private validation needs private_validation_acknowledged; requested and effective privacy remain distinct, with no silent unapproved conversion. Cover and nonempty alt are held in this path. Original resumable upload recovery reads actual offset and sends only remaining exact bytes; unknown session initialization cannot start another session. Processing/private/unlisted outcomes are not public-publication claims. Fenced original refresh reservations use current credential lease/CAS; a lost exchange acknowledgement cannot be retried automatically.\n\nTikTok: posts:tiktok plus independent posts:tiktok-video or posts:tiktok-photos, posts:media/posts:read and the write action. Descriptors tiktok.approved-video.v1 and tiktok.approved-photos.v1 bind one certified MP4/WebM/QuickTime video or 1–35 ordered certified JPEG/WebP photos. Video is at most 4 GiB, measured 360–4096 pixels per side and 23–60 fps, with supported decoded codecs and actual current creator duration limit. Photos are at most 20 MiB each, short side at most 1080 and long side at most 1920. Explicit privacy, comment/commercial/AI/music choices, content_posting_consent=true and consent_version=juno.tiktok-direct-post.20261002.v1 must match current creator restrictions. Video additionally binds duet/stitch; photos bind automatic-music choice and zero-based cover index. Source photo alt is provenance only, not native per-photo alt. Existing app/private-validation restrictions remain effective without silently changing reviewed privacy. Current video.publish scope and more than 60 seconds of credential lifetime are required; no automatic original refresh. Unknown initialization never resends. Known publish_id permits status-only recovery; it is not a public post ID and completed private outcomes may retain null public IDs.\n\nInstagram Stories: independent posts:instagram-stories plus posts:instagram/posts:media/posts:read and the write action. Descriptors instagram.approved-story-image.v1 and instagram.approved-story-video.v1 bind exactly one assigned certified JPEG up to 8,000,000 bytes or H264 MP4 up to 100,000,000 bytes and 3–60 seconds. Current cached BUSINESS identity is mandatory for the exact Instagram Login or Facebook Login/Page instance, scopes and credential revision/expiry. Canonical native copy is explicitly empty: caption, alt, cover, carousel, first comment and unsupported active options are held, never discarded or converted. The reviewed media_type is STORIES. Original protected review uses instagram_story_image or instagram_story_video roles, exact ID/SHA/storage version/certificate and leased previews. Known original container processing can resume the original publish; known media permits exact original GET readback only. Confirmation matches original owner, IMAGE/VIDEO, native STORY product and finite publication time; no feed permalink is invented.\n\nAll formats retain exact current source/review/fingerprint, original command, native account/subject/connection instance, runtime, scopes, finite authority, deletion and operator gates after awaited work and before each effect. Admission never refreshes providers. Only already qualified original publisher protocols may use fenced refresh/organization checks; their unknown refresh reservations remain held. Unknown upload/create/publish or lost dispatch acknowledgements never authorize a replacement POST, new UUID, new attempt or automatic writer retry. Recovery uses the original command UUID and the matching read operation; known native IDs authorize only the documented original processing/readback protocol. X audio, unqualified Bluesky embeds, unqualified links/GIFs, provider replies/chains beyond selected Threads formats, and format-specific delegated retries stay held. Receipt means normal pipeline admission, not confirmed publication, provider approval or observed live behavior.\n\nImmediate admission requires posts:publish. The server records its actual due time once; input supplies no client clock. Normal QStash jobs with cron fallback reauthorize the original action before each effect. An original command UUID with identical input recovers its committed receipt without another enqueue, even after its due time. Read delivery-command with current posts:read for original/current nullable outcomes. No autonomous editorial approval. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "post_id", "expected_fingerprint" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "confirm", "workspaceId", "posts" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Immutable immediate delivery admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "scheduled_for": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "fingerprint" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "action", "scheduled_for", "input_hash", "audit_id", "created_at", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "admission": { "type": "string", "enum": [ "scheduled" ] } }, "required": [ "success", "receipt", "recovered", "admission" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unqualified stored post; no batch admitted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/cancel-scheduled-posts": { "post": { "operationId": "cancelScheduledPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Separate posts:cancel or posts:reschedule authority and current posts:read for original control recovery. Confirm exact original post IDs, delivery UUIDs and loaded scheduled timestamps. Only qualified unsent work can be controlled; publishing, uncertain and completed effects refuse atomically under the provider/format guard. Any original journal or native operation also blocks captured P3/P4 controls. The current control grant needs the exact destination and independent provider/format permissions. P3/P4 captures additionally retain current original delivery authority and immutable native/source/media identities; do not generalize older unsent cancellation semantics to them. A move rechecks original review and both grant expiries, requires 2 minutes to 6 months lead and one post per account. Stable control UUID and identical input recover without another dispatch or queue deletion. Queue cancellation is best effort; canonical status/exact schedule claims fence stale jobs. No native deletion or undo of in-flight sends. GET delivery-control-command with the original control UUID returns its immutable receipt and current nullable outcomes. Unknown acknowledgement requires that GET, never a replacement command or automatic write retry. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "expected_scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "post_id", "delivery_command_id", "expected_scheduled_for" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "confirm", "workspaceId", "posts" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Immutable control admission or current outcomes", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "admission": { "type": "string", "enum": [ "cancelled", "rescheduled" ] }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "delivery_grant_id": { "type": "string", "format": "uuid" }, "previous_scheduled_for": { "type": "string" }, "scheduled_for": { "type": "string" } }, "required": [ "provider", "account_id", "post_id", "delivery_command_id", "delivery_grant_id", "previous_scheduled_for", "scheduled_for" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "input_hash", "audit_id", "created_at", "action", "admission", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "success", "receipt", "recovered" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Original control conflicts with its exact saved intention, schedule or current effect state. Preserve its original control UUID and use delivery-control-command GET recovery; do not automatically retry or invent a replacement ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unqualified move or input; no partial admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/reschedule-scheduled-posts": { "post": { "operationId": "rescheduleScheduledPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Separate posts:cancel or posts:reschedule authority and current posts:read for original control recovery. Confirm exact original post IDs, delivery UUIDs and loaded scheduled timestamps. Only qualified unsent work can be controlled; publishing, uncertain and completed effects refuse atomically under the provider/format guard. Any original journal or native operation also blocks captured P3/P4 controls. The current control grant needs the exact destination and independent provider/format permissions. P3/P4 captures additionally retain current original delivery authority and immutable native/source/media identities; do not generalize older unsent cancellation semantics to them. A move rechecks original review and both grant expiries, requires 2 minutes to 6 months lead and one post per account. Stable control UUID and identical input recover without another dispatch or queue deletion. Queue cancellation is best effort; canonical status/exact schedule claims fence stale jobs. No native deletion or undo of in-flight sends. GET delivery-control-command with the original control UUID returns its immutable receipt and current nullable outcomes. Unknown acknowledgement requires that GET, never a replacement command or automatic write retry. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "expected_scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "post_id", "delivery_command_id", "expected_scheduled_for" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "command_id", "confirm", "workspaceId", "posts", "scheduled_for" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Immutable control admission or current outcomes", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "admission": { "type": "string", "enum": [ "cancelled", "rescheduled" ] }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "delivery_grant_id": { "type": "string", "format": "uuid" }, "previous_scheduled_for": { "type": "string" }, "scheduled_for": { "type": "string" } }, "required": [ "provider", "account_id", "post_id", "delivery_command_id", "delivery_grant_id", "previous_scheduled_for", "scheduled_for" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "input_hash", "audit_id", "created_at", "action", "admission", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "success", "receipt", "recovered" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Original control conflicts with its exact saved intention, schedule or current effect state. Preserve its original control UUID and use delivery-control-command GET recovery; do not automatically retry or invent a replacement ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unqualified move or input; no partial admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/delivery-control-command": { "get": { "operationId": "readDeliveryControlCommand", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Separate posts:cancel or posts:reschedule authority and current posts:read for original control recovery. Confirm exact original post IDs, delivery UUIDs and loaded scheduled timestamps. Only qualified unsent work can be controlled; publishing, uncertain and completed effects refuse atomically under the provider/format guard. Any original journal or native operation also blocks captured P3/P4 controls. The current control grant needs the exact destination and independent provider/format permissions. P3/P4 captures additionally retain current original delivery authority and immutable native/source/media identities; do not generalize older unsent cancellation semantics to them. A move rechecks original review and both grant expiries, requires 2 minutes to 6 months lead and one post per account. Stable control UUID and identical input recover without another dispatch or queue deletion. Queue cancellation is best effort; canonical status/exact schedule claims fence stale jobs. No native deletion or undo of in-flight sends. GET delivery-control-command with the original control UUID returns its immutable receipt and current nullable outcomes. Unknown acknowledgement requires that GET, never a replacement command or automatic write retry. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Immutable control admission or current outcomes", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule", "posts:retry" ] }, "admission": { "type": "string", "enum": [ "cancelled", "rescheduled", "retry_scheduled" ] }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule", "posts:retry" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:cancel", "posts:reschedule", "posts:retry" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "delivery_command_id": { "type": "string", "format": "uuid" }, "delivery_grant_id": { "type": "string", "format": "uuid" }, "previous_scheduled_for": { "type": [ "string", "null" ] }, "scheduled_for": { "type": "string" }, "failed_attempt_number": { "type": "integer", "minimum": 1, "maximum": 2 } }, "required": [ "provider", "account_id", "post_id", "delivery_command_id", "delivery_grant_id", "previous_scheduled_for", "scheduled_for" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "input_hash", "audit_id", "created_at", "action", "admission", "delegated_actor", "posts" ], "additionalProperties": false }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "status": { "type": [ "string", "null" ] }, "scheduled_for": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "provider_post_id": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." } }, "required": [ "provider", "account_id", "post_id", "status", "scheduled_for", "published_at", "provider_post_id", "reason" ] } } }, "required": [ "success", "receipt", "posts" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Original control conflicts with its exact saved intention, schedule or current effect state. Preserve its original control UUID and use delivery-control-command GET recovery; do not automatically retry or invent a replacement ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unqualified move or input; no partial admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/schedule-approved-posts": { "post": { "operationId": "scheduleApprovedPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Reviewed Facebook feed video and Reels, X video and Bluesky video require independent posts:facebook-video, posts:facebook-reels, posts:x-video or posts:bluesky-video, plus the base provider, posts:media, posts:read and requested publish/schedule permission on the same current finite grant and exact target. Existing grants gain no authority. Each binds one assigned current fully certified original asset, SHA-256 and Storage version. Facebook VIDEO uses delivery_format=facebook.approved-video.v1 and format=registered_video; REELS uses facebook.approved-reels.v1 and registered_reel. Facebook H264 MP4/MOV supports up to 4 GiB, feed 1 second–4 hours; Reels 3–90 seconds with actual constant 24–60 fps, minimum 540x960 and display ratio 9:16–16:9, original compliant audio. No video alt or unqualified options. X uses x.approved-video.v1 and registered_media: H264 MP4 up to 8 GiB, 0.5–1200 seconds, square pixels, 32px minimum, short side at most 1024/long side 1280, ratio 1:3–3:1, at most 60 fps and original AAC-LC mono/stereo or silence. Historical certificates lacking actual square-pixel/audio/segment evidence require revalidation; no replacement audio, cover or alt. Bluesky uses bluesky.approved-video.v1 and registered_media: one H264 MP4 up to 300,000,000 bytes and ten minutes; optional exact untrimmed description up to 2000 Unicode code points, default empty; caption at most 300 graphemes/3000 UTF-8 bytes. Native account quota remains required. Upload completion is not certification: native uploads remain pending until complete original-byte decoding, SHA and segment proofs finish. Original owner review/source, grant, account/session, command, certificate and current authority are repeated at execution and recovery. Acknowledged progress resumes only in the original attempt; uncertain writes stay held and recover by exact original native readback, never replacement command or resend. Admission/processing is not confirmed publication. Workspace quotas remain separate from native limits.\n\nApproved delivery accepts existing currently editorial-approved posts only. Reads require posts:read; each write requires its requested posts:schedule or posts:publish action, exact destination, provider opt-in and every selected format opt-in on one current named grant. Preparation, ordinary API keys, OAuth bindings and broad media permission do not supply these independent consents. Existing grants gain no new format. Every selected post must pass normal content preflight; the batch admits all targets or none, with one post per account. Registered media binds original ordered IDs, SHA-256, owner/workspace/account assignment, exact bytes, current certificate and immutable storage-object version; arbitrary stored or caller URLs are not evidence.\n\nThreads: plain text; text chains require posts:chains; registered root media requires posts:media; registered per-segment media chains require posts:media-chains plus posts:chains and posts:media, at most one certified asset per segment and 20 distinct assets per chain. Root-media certificate/count/byte rules remain independent from chain rules. Polls require posts:threads-polls (threads.approved-poll.v1); stored-parent replies require posts:threads-replies (threads.approved-reply.v1); stored-parent quotes require posts:threads-quotes (threads.approved-quote.v1); compound interaction chains require posts:threads-interaction-chains plus posts:chains and each applicable root poll/reply/quote opt-in (threads.approved-interaction-chain.v1). Interactions are plaintext only, with 2–4 ordered poll choices (at most 25 characters each), at most 500 UTF-8 bytes per segment, and existing one-root/100-reply capacity. Reply/quote parents must be exact-account stored published posts or qualified inbox reply/mention selectors; bare external IDs cannot substitute for provenance. Reply and quote are exclusive. Media and other active incompatible options remain held for these interaction descriptors.\n\nBluesky single image requires posts:bluesky-images plus posts:bluesky/posts:media/posts:read and the write action: one certified JPEG/PNG/WebP up to 2,000,000 bytes, nonempty already-trimmed approved alt up to 2000 characters, native caption at most 300 graphemes/3000 UTF-8 bytes. Reviewed Bluesky multiple images require independent posts:bluesky-multiple-images plus posts:bluesky, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact native account. Existing plaintext and posts:bluesky-images single-image grants gain no multiple-image permission. Bound 2–4 ordered current certified assigned immutable Library JPEG/PNG/WebP images, each at most 2,000,000 bytes with positive integer dimensions. Caption may be empty, otherwise at most 300 graphemes and 3,000 UTF-8 bytes. Each reviewed alt must be nonempty, already trimmed and at most 2000 Unicode code points, preserved exactly. Candidates and receipts retain delivery_format=bluesky.approved-multiple-images.v1, existing format=registered_media and ordered media_refs (id,sha256,alt_text). Original source/review, native DID/session/revision/scopes, certified object versions, command and attempt remain bound. Unknown uploads or record creation hold without writer replay; only positively unsent progress within the original lease or exact original known-record GET readback may recover under current authority. Plaintext and the established one-image helper and permission retain their limits and ABI. No galleries, video, other embeds, replies, quotes, chains, delegated retry or legacy OAuth v1/v2 delivery.\n\nReviewed X images require independent posts:x-images plus posts:x, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact X account. Existing plaintext grants gain no image permission. Bound 1–4 ordered current certified assigned immutable Library JPEG/PNG images, each at most 5,000,000 exact bytes with positive integer dimensions, and exact untrimmed per-image alt text at most 1000 Unicode characters. Caption may be empty; otherwise the native weighted parser must accept at most 280 characters and one cashtag. Candidates/receipts retain delivery_format=x.approved-images.v1, existing format=registered_media, and ordered media_refs (id,sha256,alt_text). Original source/review, native account instance/subject/credential, object versions, command and attempt remain bound. Unknown upload/metadata/publication effects hold without writer replay; only original acknowledged progress or known-post GET readback may recover under current authority. No image-path credential refresh, first comments, replies, quotes, chains, GIF/WebP/video/audio, delegated retry, legacy OAuth v1/v2 delivery or provider-entitlement expansion.\n\nReviewed LinkedIn member/organization images require independent posts:linkedin-images plus posts:linkedin, posts:media, posts:read and the requested schedule/publish action on the same current grant; existing plaintext grants gain no image permission. Bound 1–20 ordered certified assigned immutable Library JPEG/PNG images, each at most 10,000,000 bytes and fewer than 36,152,320 pixels, exact nonempty commentary at most 3000 string units, and reviewed per-image alt text at most 4086 Unicode characters. Only PUBLIC visibility and MAIN_FEED distribution with empty targeting/channels, PUBLISHED lifecycle and reshare-disabled=false qualify. Candidates/receipts preserve delivery_format=linkedin.approved-images.v1 and exact ordered media_refs (id,sha256,alt_text). Original destination/connection/member/subject/author/credential, review, object versions and attempt remain mandatory. Unknown initialization or publication holds without replay; unknown byte upload permits only exact original image-URN readiness GET. Positively unsent progress needs the original lease; known post URNs permit exact original GET readback. Unavailable read/permission proof remains unavailable. The image path does not refresh tokens or authorize video/document/GIF, replies/chains/retry or legacy OAuth v1/v2 delivery; video and PDF use the separate permissions and paths below.\n\nReviewed Facebook Page plaintext requires posts:facebook; 1–10 assigned certified immutable Library JPEG/PNG images (each at most 10,000,000 bytes) additionally require independent posts:facebook-images and posts:media on the same posts:read and schedule/publish grant. Ordered exact asset IDs, SHA-256, storage versions and reviewed per-image alt text (at most 1000 characters) remain bound to the original Page credential, approved source and original attempt. Image-only caption may be empty. Original acknowledged photo IDs are published in approved order; unknown upload/publication effects hold without replay. Only positively unsent original-lease progress or exact known-post GET readback may recover. Facebook video, chains, delegated retry and legacy OAuth v1/v2 delivery remain held.\n\nReviewed Instagram Reels require independent posts:instagram-video; reviewed JPEG carousels require independent posts:instagram-carousel. Each also requires posts:instagram, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact account. Descriptors are instagram.approved-video.v1 and instagram.approved-carousel.v1 with existing format=registered_media and exact ordered media_refs. Reels bind one certified assigned MP4/H264 up to 300,000,000 bytes and 3–900 seconds with actual decoded frame/audio/layout evidence, exact embedded original audio, separately certified JPEG cover or original frame offset, and reviewed share_to_feed/audio_name/is_ai_generated options. Carousels bind 2–10 distinct certified assigned JPEGs up to 8,000,000 bytes each, aspect 0.8–1.91 and untrimmed alt text up to 1000 Unicode code points. Empty media captions are valid; normal Juno caption limit remains 2200 UTF-16 units. Both login modes require the original current native subject/creation identity, selected direct or Page credential, finite scopes/expiry, source/review, certificate/object version, command and attempt. Unknown child/parent/publish writes hold without resend; recovery uses original protected inputs, positively unsent progress or exact known-container/media GET, never replacement URLs, refresh or guessed IDs. Requested unavailable observable proof holds. Existing single-JPEG grants gain no P2 permission.\n\nReviewed Instagram caption plus one assigned certified Library JPEG requires independent posts:instagram and posts:media on the same posts:read/schedule-or-publish grant, exact original native login/subject/Page credential and certified object version, original attempt only. Unknown create/publish effects hold without resend; only original known-container progress or exact known-media readback may recover. The single-JPEG permission does not authorize Reels, carousels or Stories; those require the separate opt-ins described here. Caption-only, PNG, replies/chains/retry/legacy OAuth v1/v2 delivery and nonempty unqualified alt/native metadata remain outside this single-JPEG path.\n\nLinkedIn video/PDF: independent posts:linkedin-video or posts:linkedin-document, plus posts:linkedin/posts:media/posts:read and the requested write action. Descriptors linkedin.approved-video.v1 and linkedin.approved-document.v1 bind one original asset and explicit native title/options. Video is certified full-decoded H264 MP4, 75,000–500,000,000 bytes and 3–1800 seconds, preserving original embedded audio and ordered original multipart ranges; optional selected distinct JPEG/PNG cover is separately certified and at most 10 MB. Document is certified unencrypted PDF up to 100,000,000 bytes with a valid bounded 1–300-page tree, explicit title and no cover. Title is 1–400 Unicode characters, separate from commentary. Exact current member/organization destination, native revision/scopes/credential, approved source and original operation remain required. Unknown initialization/publication holds without replay; known original upload/URN progress and exact original readback recover only within the qualified native protocol. Media recovery introduces no credential refresh.\n\nPinterest: posts:pinterest plus independent posts:pinterest-images or posts:pinterest-video, posts:media/posts:read and the write action. Descriptors pinterest.approved-images.v1 and pinterest.approved-video.v1 target the explicitly selected acknowledged local/native board, never an arbitrary first board. PUBLIC or SECRET boards need matching acknowledged ownership; PROTECTED or unproven shared boards hold. Image is one certified JPEG/PNG; video is original certified H264 MP4 plus a separately selected JPEG/PNG cover in reviewed order. Juno bounds each asset to 10,000,000 bytes; video is at least 75,000 bytes and 4–300 seconds. Title, description, required Pin accessibility text, optional HTTPS destination and selected AI disclosure remain exact. media_refs include id,sha256,role,mime_type,file_size,alt_text. Registration/upload/create are original irreversible phases; unknown registration or Pin create without an ID holds. Known registered-media processing and known Pin readback use only the original IDs; no new upload, signed URL or attempt is inferred. Delegated access needs more than 60 seconds of current cached lifetime and is not refreshed.\n\nYouTube: posts:youtube/posts:media/posts:read and the write action. Descriptors youtube.approved-video.v1 and youtube.approved-shorts.v1 bind one original fully decoded H264 MP4, AAC or silent audio, up to 500 MB and 0.5–900 seconds. Shorts eligibility additionally needs square/portrait geometry and at most 180 seconds; it does not establish native Shorts classification. Explicit title, description, tags, category, requested privacy, made-for-kids, synthetic-media disclosure, subscriber notification, delivery_format and consent version youtube-certified-video-20261002-v1 remain reviewed. Required private validation needs private_validation_acknowledged; requested and effective privacy remain distinct, with no silent unapproved conversion. Cover and nonempty alt are held in this path. Original resumable upload recovery reads actual offset and sends only remaining exact bytes; unknown session initialization cannot start another session. Processing/private/unlisted outcomes are not public-publication claims. Fenced original refresh reservations use current credential lease/CAS; a lost exchange acknowledgement cannot be retried automatically.\n\nTikTok: posts:tiktok plus independent posts:tiktok-video or posts:tiktok-photos, posts:media/posts:read and the write action. Descriptors tiktok.approved-video.v1 and tiktok.approved-photos.v1 bind one certified MP4/WebM/QuickTime video or 1–35 ordered certified JPEG/WebP photos. Video is at most 4 GiB, measured 360–4096 pixels per side and 23–60 fps, with supported decoded codecs and actual current creator duration limit. Photos are at most 20 MiB each, short side at most 1080 and long side at most 1920. Explicit privacy, comment/commercial/AI/music choices, content_posting_consent=true and consent_version=juno.tiktok-direct-post.20261002.v1 must match current creator restrictions. Video additionally binds duet/stitch; photos bind automatic-music choice and zero-based cover index. Source photo alt is provenance only, not native per-photo alt. Existing app/private-validation restrictions remain effective without silently changing reviewed privacy. Current video.publish scope and more than 60 seconds of credential lifetime are required; no automatic original refresh. Unknown initialization never resends. Known publish_id permits status-only recovery; it is not a public post ID and completed private outcomes may retain null public IDs.\n\nInstagram Stories: independent posts:instagram-stories plus posts:instagram/posts:media/posts:read and the write action. Descriptors instagram.approved-story-image.v1 and instagram.approved-story-video.v1 bind exactly one assigned certified JPEG up to 8,000,000 bytes or H264 MP4 up to 100,000,000 bytes and 3–60 seconds. Current cached BUSINESS identity is mandatory for the exact Instagram Login or Facebook Login/Page instance, scopes and credential revision/expiry. Canonical native copy is explicitly empty: caption, alt, cover, carousel, first comment and unsupported active options are held, never discarded or converted. The reviewed media_type is STORIES. Original protected review uses instagram_story_image or instagram_story_video roles, exact ID/SHA/storage version/certificate and leased previews. Known original container processing can resume the original publish; known media permits exact original GET readback only. Confirmation matches original owner, IMAGE/VIDEO, native STORY product and finite publication time; no feed permalink is invented.\n\nAll formats retain exact current source/review/fingerprint, original command, native account/subject/connection instance, runtime, scopes, finite authority, deletion and operator gates after awaited work and before each effect. Admission never refreshes providers. Only already qualified original publisher protocols may use fenced refresh/organization checks; their unknown refresh reservations remain held. Unknown upload/create/publish or lost dispatch acknowledgements never authorize a replacement POST, new UUID, new attempt or automatic writer retry. Recovery uses the original command UUID and the matching read operation; known native IDs authorize only the documented original processing/readback protocol. X audio, unqualified Bluesky embeds, unqualified links/GIFs, provider replies/chains beyond selected Threads formats, and format-specific delegated retries stay held. Receipt means normal pipeline admission, not confirmed publication, provider approval or observed live behavior.\n\nReads require posts:read; scheduling requires posts:schedule. Confirm exact currently approved post fingerprints and a schedule 2 minutes to 6 months ahead, strictly before finite grant expiry. Legacy/preparation credentials do not qualify. List uses a post-ID keyset after with limit at most 100, not a snapshot. Original UUID and identical input recover without preflight/lease/enqueue again, including after the original schedule; changed input conflicts. Current post status and provider IDs remain nullable, and removed originals retain only their safe immutable receipts. Controls and retries require their separate qualified permissions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "post_id", "expected_fingerprint" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "command_id", "confirm", "workspaceId", "posts", "scheduled_for" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Current candidates, command outcome or immutable scheduling admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "scheduled_for": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "fingerprint" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "action", "scheduled_for", "input_hash", "audit_id", "created_at", "delegated_actor", "posts" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "admission": { "type": "string", "enum": [ "scheduled" ] } }, "required": [ "success", "receipt", "recovered", "admission" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unsupported post, schedule or stored preflight; no batch admitted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/approved-posts": { "get": { "operationId": "listApprovedPosts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Reviewed Facebook feed video and Reels, X video and Bluesky video require independent posts:facebook-video, posts:facebook-reels, posts:x-video or posts:bluesky-video, plus the base provider, posts:media, posts:read and requested publish/schedule permission on the same current finite grant and exact target. Existing grants gain no authority. Each binds one assigned current fully certified original asset, SHA-256 and Storage version. Facebook VIDEO uses delivery_format=facebook.approved-video.v1 and format=registered_video; REELS uses facebook.approved-reels.v1 and registered_reel. Facebook H264 MP4/MOV supports up to 4 GiB, feed 1 second–4 hours; Reels 3–90 seconds with actual constant 24–60 fps, minimum 540x960 and display ratio 9:16–16:9, original compliant audio. No video alt or unqualified options. X uses x.approved-video.v1 and registered_media: H264 MP4 up to 8 GiB, 0.5–1200 seconds, square pixels, 32px minimum, short side at most 1024/long side 1280, ratio 1:3–3:1, at most 60 fps and original AAC-LC mono/stereo or silence. Historical certificates lacking actual square-pixel/audio/segment evidence require revalidation; no replacement audio, cover or alt. Bluesky uses bluesky.approved-video.v1 and registered_media: one H264 MP4 up to 300,000,000 bytes and ten minutes; optional exact untrimmed description up to 2000 Unicode code points, default empty; caption at most 300 graphemes/3000 UTF-8 bytes. Native account quota remains required. Upload completion is not certification: native uploads remain pending until complete original-byte decoding, SHA and segment proofs finish. Original owner review/source, grant, account/session, command, certificate and current authority are repeated at execution and recovery. Acknowledged progress resumes only in the original attempt; uncertain writes stay held and recover by exact original native readback, never replacement command or resend. Admission/processing is not confirmed publication. Workspace quotas remain separate from native limits.\n\nApproved delivery accepts existing currently editorial-approved posts only. Reads require posts:read; each write requires its requested posts:schedule or posts:publish action, exact destination, provider opt-in and every selected format opt-in on one current named grant. Preparation, ordinary API keys, OAuth bindings and broad media permission do not supply these independent consents. Existing grants gain no new format. Every selected post must pass normal content preflight; the batch admits all targets or none, with one post per account. Registered media binds original ordered IDs, SHA-256, owner/workspace/account assignment, exact bytes, current certificate and immutable storage-object version; arbitrary stored or caller URLs are not evidence.\n\nThreads: plain text; text chains require posts:chains; registered root media requires posts:media; registered per-segment media chains require posts:media-chains plus posts:chains and posts:media, at most one certified asset per segment and 20 distinct assets per chain. Root-media certificate/count/byte rules remain independent from chain rules. Polls require posts:threads-polls (threads.approved-poll.v1); stored-parent replies require posts:threads-replies (threads.approved-reply.v1); stored-parent quotes require posts:threads-quotes (threads.approved-quote.v1); compound interaction chains require posts:threads-interaction-chains plus posts:chains and each applicable root poll/reply/quote opt-in (threads.approved-interaction-chain.v1). Interactions are plaintext only, with 2–4 ordered poll choices (at most 25 characters each), at most 500 UTF-8 bytes per segment, and existing one-root/100-reply capacity. Reply/quote parents must be exact-account stored published posts or qualified inbox reply/mention selectors; bare external IDs cannot substitute for provenance. Reply and quote are exclusive. Media and other active incompatible options remain held for these interaction descriptors.\n\nBluesky single image requires posts:bluesky-images plus posts:bluesky/posts:media/posts:read and the write action: one certified JPEG/PNG/WebP up to 2,000,000 bytes, nonempty already-trimmed approved alt up to 2000 characters, native caption at most 300 graphemes/3000 UTF-8 bytes. Reviewed Bluesky multiple images require independent posts:bluesky-multiple-images plus posts:bluesky, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact native account. Existing plaintext and posts:bluesky-images single-image grants gain no multiple-image permission. Bound 2–4 ordered current certified assigned immutable Library JPEG/PNG/WebP images, each at most 2,000,000 bytes with positive integer dimensions. Caption may be empty, otherwise at most 300 graphemes and 3,000 UTF-8 bytes. Each reviewed alt must be nonempty, already trimmed and at most 2000 Unicode code points, preserved exactly. Candidates and receipts retain delivery_format=bluesky.approved-multiple-images.v1, existing format=registered_media and ordered media_refs (id,sha256,alt_text). Original source/review, native DID/session/revision/scopes, certified object versions, command and attempt remain bound. Unknown uploads or record creation hold without writer replay; only positively unsent progress within the original lease or exact original known-record GET readback may recover under current authority. Plaintext and the established one-image helper and permission retain their limits and ABI. No galleries, video, other embeds, replies, quotes, chains, delegated retry or legacy OAuth v1/v2 delivery.\n\nReviewed X images require independent posts:x-images plus posts:x, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact X account. Existing plaintext grants gain no image permission. Bound 1–4 ordered current certified assigned immutable Library JPEG/PNG images, each at most 5,000,000 exact bytes with positive integer dimensions, and exact untrimmed per-image alt text at most 1000 Unicode characters. Caption may be empty; otherwise the native weighted parser must accept at most 280 characters and one cashtag. Candidates/receipts retain delivery_format=x.approved-images.v1, existing format=registered_media, and ordered media_refs (id,sha256,alt_text). Original source/review, native account instance/subject/credential, object versions, command and attempt remain bound. Unknown upload/metadata/publication effects hold without writer replay; only original acknowledged progress or known-post GET readback may recover under current authority. No image-path credential refresh, first comments, replies, quotes, chains, GIF/WebP/video/audio, delegated retry, legacy OAuth v1/v2 delivery or provider-entitlement expansion.\n\nReviewed LinkedIn member/organization images require independent posts:linkedin-images plus posts:linkedin, posts:media, posts:read and the requested schedule/publish action on the same current grant; existing plaintext grants gain no image permission. Bound 1–20 ordered certified assigned immutable Library JPEG/PNG images, each at most 10,000,000 bytes and fewer than 36,152,320 pixels, exact nonempty commentary at most 3000 string units, and reviewed per-image alt text at most 4086 Unicode characters. Only PUBLIC visibility and MAIN_FEED distribution with empty targeting/channels, PUBLISHED lifecycle and reshare-disabled=false qualify. Candidates/receipts preserve delivery_format=linkedin.approved-images.v1 and exact ordered media_refs (id,sha256,alt_text). Original destination/connection/member/subject/author/credential, review, object versions and attempt remain mandatory. Unknown initialization or publication holds without replay; unknown byte upload permits only exact original image-URN readiness GET. Positively unsent progress needs the original lease; known post URNs permit exact original GET readback. Unavailable read/permission proof remains unavailable. The image path does not refresh tokens or authorize video/document/GIF, replies/chains/retry or legacy OAuth v1/v2 delivery; video and PDF use the separate permissions and paths below.\n\nReviewed Facebook Page plaintext requires posts:facebook; 1–10 assigned certified immutable Library JPEG/PNG images (each at most 10,000,000 bytes) additionally require independent posts:facebook-images and posts:media on the same posts:read and schedule/publish grant. Ordered exact asset IDs, SHA-256, storage versions and reviewed per-image alt text (at most 1000 characters) remain bound to the original Page credential, approved source and original attempt. Image-only caption may be empty. Original acknowledged photo IDs are published in approved order; unknown upload/publication effects hold without replay. Only positively unsent original-lease progress or exact known-post GET readback may recover. Facebook video, chains, delegated retry and legacy OAuth v1/v2 delivery remain held.\n\nReviewed Instagram Reels require independent posts:instagram-video; reviewed JPEG carousels require independent posts:instagram-carousel. Each also requires posts:instagram, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact account. Descriptors are instagram.approved-video.v1 and instagram.approved-carousel.v1 with existing format=registered_media and exact ordered media_refs. Reels bind one certified assigned MP4/H264 up to 300,000,000 bytes and 3–900 seconds with actual decoded frame/audio/layout evidence, exact embedded original audio, separately certified JPEG cover or original frame offset, and reviewed share_to_feed/audio_name/is_ai_generated options. Carousels bind 2–10 distinct certified assigned JPEGs up to 8,000,000 bytes each, aspect 0.8–1.91 and untrimmed alt text up to 1000 Unicode code points. Empty media captions are valid; normal Juno caption limit remains 2200 UTF-16 units. Both login modes require the original current native subject/creation identity, selected direct or Page credential, finite scopes/expiry, source/review, certificate/object version, command and attempt. Unknown child/parent/publish writes hold without resend; recovery uses original protected inputs, positively unsent progress or exact known-container/media GET, never replacement URLs, refresh or guessed IDs. Requested unavailable observable proof holds. Existing single-JPEG grants gain no P2 permission.\n\nReviewed Instagram caption plus one assigned certified Library JPEG requires independent posts:instagram and posts:media on the same posts:read/schedule-or-publish grant, exact original native login/subject/Page credential and certified object version, original attempt only. Unknown create/publish effects hold without resend; only original known-container progress or exact known-media readback may recover. The single-JPEG permission does not authorize Reels, carousels or Stories; those require the separate opt-ins described here. Caption-only, PNG, replies/chains/retry/legacy OAuth v1/v2 delivery and nonempty unqualified alt/native metadata remain outside this single-JPEG path.\n\nLinkedIn video/PDF: independent posts:linkedin-video or posts:linkedin-document, plus posts:linkedin/posts:media/posts:read and the requested write action. Descriptors linkedin.approved-video.v1 and linkedin.approved-document.v1 bind one original asset and explicit native title/options. Video is certified full-decoded H264 MP4, 75,000–500,000,000 bytes and 3–1800 seconds, preserving original embedded audio and ordered original multipart ranges; optional selected distinct JPEG/PNG cover is separately certified and at most 10 MB. Document is certified unencrypted PDF up to 100,000,000 bytes with a valid bounded 1–300-page tree, explicit title and no cover. Title is 1–400 Unicode characters, separate from commentary. Exact current member/organization destination, native revision/scopes/credential, approved source and original operation remain required. Unknown initialization/publication holds without replay; known original upload/URN progress and exact original readback recover only within the qualified native protocol. Media recovery introduces no credential refresh.\n\nPinterest: posts:pinterest plus independent posts:pinterest-images or posts:pinterest-video, posts:media/posts:read and the write action. Descriptors pinterest.approved-images.v1 and pinterest.approved-video.v1 target the explicitly selected acknowledged local/native board, never an arbitrary first board. PUBLIC or SECRET boards need matching acknowledged ownership; PROTECTED or unproven shared boards hold. Image is one certified JPEG/PNG; video is original certified H264 MP4 plus a separately selected JPEG/PNG cover in reviewed order. Juno bounds each asset to 10,000,000 bytes; video is at least 75,000 bytes and 4–300 seconds. Title, description, required Pin accessibility text, optional HTTPS destination and selected AI disclosure remain exact. media_refs include id,sha256,role,mime_type,file_size,alt_text. Registration/upload/create are original irreversible phases; unknown registration or Pin create without an ID holds. Known registered-media processing and known Pin readback use only the original IDs; no new upload, signed URL or attempt is inferred. Delegated access needs more than 60 seconds of current cached lifetime and is not refreshed.\n\nYouTube: posts:youtube/posts:media/posts:read and the write action. Descriptors youtube.approved-video.v1 and youtube.approved-shorts.v1 bind one original fully decoded H264 MP4, AAC or silent audio, up to 500 MB and 0.5–900 seconds. Shorts eligibility additionally needs square/portrait geometry and at most 180 seconds; it does not establish native Shorts classification. Explicit title, description, tags, category, requested privacy, made-for-kids, synthetic-media disclosure, subscriber notification, delivery_format and consent version youtube-certified-video-20261002-v1 remain reviewed. Required private validation needs private_validation_acknowledged; requested and effective privacy remain distinct, with no silent unapproved conversion. Cover and nonempty alt are held in this path. Original resumable upload recovery reads actual offset and sends only remaining exact bytes; unknown session initialization cannot start another session. Processing/private/unlisted outcomes are not public-publication claims. Fenced original refresh reservations use current credential lease/CAS; a lost exchange acknowledgement cannot be retried automatically.\n\nTikTok: posts:tiktok plus independent posts:tiktok-video or posts:tiktok-photos, posts:media/posts:read and the write action. Descriptors tiktok.approved-video.v1 and tiktok.approved-photos.v1 bind one certified MP4/WebM/QuickTime video or 1–35 ordered certified JPEG/WebP photos. Video is at most 4 GiB, measured 360–4096 pixels per side and 23–60 fps, with supported decoded codecs and actual current creator duration limit. Photos are at most 20 MiB each, short side at most 1080 and long side at most 1920. Explicit privacy, comment/commercial/AI/music choices, content_posting_consent=true and consent_version=juno.tiktok-direct-post.20261002.v1 must match current creator restrictions. Video additionally binds duet/stitch; photos bind automatic-music choice and zero-based cover index. Source photo alt is provenance only, not native per-photo alt. Existing app/private-validation restrictions remain effective without silently changing reviewed privacy. Current video.publish scope and more than 60 seconds of credential lifetime are required; no automatic original refresh. Unknown initialization never resends. Known publish_id permits status-only recovery; it is not a public post ID and completed private outcomes may retain null public IDs.\n\nInstagram Stories: independent posts:instagram-stories plus posts:instagram/posts:media/posts:read and the write action. Descriptors instagram.approved-story-image.v1 and instagram.approved-story-video.v1 bind exactly one assigned certified JPEG up to 8,000,000 bytes or H264 MP4 up to 100,000,000 bytes and 3–60 seconds. Current cached BUSINESS identity is mandatory for the exact Instagram Login or Facebook Login/Page instance, scopes and credential revision/expiry. Canonical native copy is explicitly empty: caption, alt, cover, carousel, first comment and unsupported active options are held, never discarded or converted. The reviewed media_type is STORIES. Original protected review uses instagram_story_image or instagram_story_video roles, exact ID/SHA/storage version/certificate and leased previews. Known original container processing can resume the original publish; known media permits exact original GET readback only. Confirmation matches original owner, IMAGE/VIDEO, native STORY product and finite publication time; no feed permalink is invented.\n\nAll formats retain exact current source/review/fingerprint, original command, native account/subject/connection instance, runtime, scopes, finite authority, deletion and operator gates after awaited work and before each effect. Admission never refreshes providers. Only already qualified original publisher protocols may use fenced refresh/organization checks; their unknown refresh reservations remain held. Unknown upload/create/publish or lost dispatch acknowledgements never authorize a replacement POST, new UUID, new attempt or automatic writer retry. Recovery uses the original command UUID and the matching read operation; known native IDs authorize only the documented original processing/readback protocol. X audio, unqualified Bluesky embeds, unqualified links/GIFs, provider replies/chains beyond selected Threads formats, and format-specific delegated retries stay held. Receipt means normal pipeline admission, not confirmed publication, provider approval or observed live behavior.\n\nReads require posts:read; scheduling requires posts:schedule. Confirm exact currently approved post fingerprints and a schedule 2 minutes to 6 months ahead, strictly before finite grant expiry. Legacy/preparation credentials do not qualify. List uses a post-ID keyset after with limit at most 100, not a snapshot. Original UUID and identical input recover without preflight/lease/enqueue again, including after the original schedule; changed input conflicts. Current post status and provider IDs remain nullable, and removed originals retain only their safe immutable receipts. Controls and retries require their separate qualified permissions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "after", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Current candidates, command outcome or immutable scheduling admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "content": { "type": "string" }, "draft_id": { "type": "string", "format": "uuid" }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "content", "draft_id", "fingerprint" ] } }, "next_after": { "type": [ "string", "null" ] } }, "required": [ "success", "posts", "next_after" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unsupported post, schedule or stored preflight; no batch admitted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/delivery-command": { "get": { "operationId": "readDeliveryCommand", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Reviewed Facebook feed video and Reels, X video and Bluesky video require independent posts:facebook-video, posts:facebook-reels, posts:x-video or posts:bluesky-video, plus the base provider, posts:media, posts:read and requested publish/schedule permission on the same current finite grant and exact target. Existing grants gain no authority. Each binds one assigned current fully certified original asset, SHA-256 and Storage version. Facebook VIDEO uses delivery_format=facebook.approved-video.v1 and format=registered_video; REELS uses facebook.approved-reels.v1 and registered_reel. Facebook H264 MP4/MOV supports up to 4 GiB, feed 1 second–4 hours; Reels 3–90 seconds with actual constant 24–60 fps, minimum 540x960 and display ratio 9:16–16:9, original compliant audio. No video alt or unqualified options. X uses x.approved-video.v1 and registered_media: H264 MP4 up to 8 GiB, 0.5–1200 seconds, square pixels, 32px minimum, short side at most 1024/long side 1280, ratio 1:3–3:1, at most 60 fps and original AAC-LC mono/stereo or silence. Historical certificates lacking actual square-pixel/audio/segment evidence require revalidation; no replacement audio, cover or alt. Bluesky uses bluesky.approved-video.v1 and registered_media: one H264 MP4 up to 300,000,000 bytes and ten minutes; optional exact untrimmed description up to 2000 Unicode code points, default empty; caption at most 300 graphemes/3000 UTF-8 bytes. Native account quota remains required. Upload completion is not certification: native uploads remain pending until complete original-byte decoding, SHA and segment proofs finish. Original owner review/source, grant, account/session, command, certificate and current authority are repeated at execution and recovery. Acknowledged progress resumes only in the original attempt; uncertain writes stay held and recover by exact original native readback, never replacement command or resend. Admission/processing is not confirmed publication. Workspace quotas remain separate from native limits.\n\nApproved delivery accepts existing currently editorial-approved posts only. Reads require posts:read; each write requires its requested posts:schedule or posts:publish action, exact destination, provider opt-in and every selected format opt-in on one current named grant. Preparation, ordinary API keys, OAuth bindings and broad media permission do not supply these independent consents. Existing grants gain no new format. Every selected post must pass normal content preflight; the batch admits all targets or none, with one post per account. Registered media binds original ordered IDs, SHA-256, owner/workspace/account assignment, exact bytes, current certificate and immutable storage-object version; arbitrary stored or caller URLs are not evidence.\n\nThreads: plain text; text chains require posts:chains; registered root media requires posts:media; registered per-segment media chains require posts:media-chains plus posts:chains and posts:media, at most one certified asset per segment and 20 distinct assets per chain. Root-media certificate/count/byte rules remain independent from chain rules. Polls require posts:threads-polls (threads.approved-poll.v1); stored-parent replies require posts:threads-replies (threads.approved-reply.v1); stored-parent quotes require posts:threads-quotes (threads.approved-quote.v1); compound interaction chains require posts:threads-interaction-chains plus posts:chains and each applicable root poll/reply/quote opt-in (threads.approved-interaction-chain.v1). Interactions are plaintext only, with 2–4 ordered poll choices (at most 25 characters each), at most 500 UTF-8 bytes per segment, and existing one-root/100-reply capacity. Reply/quote parents must be exact-account stored published posts or qualified inbox reply/mention selectors; bare external IDs cannot substitute for provenance. Reply and quote are exclusive. Media and other active incompatible options remain held for these interaction descriptors.\n\nBluesky single image requires posts:bluesky-images plus posts:bluesky/posts:media/posts:read and the write action: one certified JPEG/PNG/WebP up to 2,000,000 bytes, nonempty already-trimmed approved alt up to 2000 characters, native caption at most 300 graphemes/3000 UTF-8 bytes. Reviewed Bluesky multiple images require independent posts:bluesky-multiple-images plus posts:bluesky, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact native account. Existing plaintext and posts:bluesky-images single-image grants gain no multiple-image permission. Bound 2–4 ordered current certified assigned immutable Library JPEG/PNG/WebP images, each at most 2,000,000 bytes with positive integer dimensions. Caption may be empty, otherwise at most 300 graphemes and 3,000 UTF-8 bytes. Each reviewed alt must be nonempty, already trimmed and at most 2000 Unicode code points, preserved exactly. Candidates and receipts retain delivery_format=bluesky.approved-multiple-images.v1, existing format=registered_media and ordered media_refs (id,sha256,alt_text). Original source/review, native DID/session/revision/scopes, certified object versions, command and attempt remain bound. Unknown uploads or record creation hold without writer replay; only positively unsent progress within the original lease or exact original known-record GET readback may recover under current authority. Plaintext and the established one-image helper and permission retain their limits and ABI. No galleries, video, other embeds, replies, quotes, chains, delegated retry or legacy OAuth v1/v2 delivery.\n\nReviewed X images require independent posts:x-images plus posts:x, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact X account. Existing plaintext grants gain no image permission. Bound 1–4 ordered current certified assigned immutable Library JPEG/PNG images, each at most 5,000,000 exact bytes with positive integer dimensions, and exact untrimmed per-image alt text at most 1000 Unicode characters. Caption may be empty; otherwise the native weighted parser must accept at most 280 characters and one cashtag. Candidates/receipts retain delivery_format=x.approved-images.v1, existing format=registered_media, and ordered media_refs (id,sha256,alt_text). Original source/review, native account instance/subject/credential, object versions, command and attempt remain bound. Unknown upload/metadata/publication effects hold without writer replay; only original acknowledged progress or known-post GET readback may recover under current authority. No image-path credential refresh, first comments, replies, quotes, chains, GIF/WebP/video/audio, delegated retry, legacy OAuth v1/v2 delivery or provider-entitlement expansion.\n\nReviewed LinkedIn member/organization images require independent posts:linkedin-images plus posts:linkedin, posts:media, posts:read and the requested schedule/publish action on the same current grant; existing plaintext grants gain no image permission. Bound 1–20 ordered certified assigned immutable Library JPEG/PNG images, each at most 10,000,000 bytes and fewer than 36,152,320 pixels, exact nonempty commentary at most 3000 string units, and reviewed per-image alt text at most 4086 Unicode characters. Only PUBLIC visibility and MAIN_FEED distribution with empty targeting/channels, PUBLISHED lifecycle and reshare-disabled=false qualify. Candidates/receipts preserve delivery_format=linkedin.approved-images.v1 and exact ordered media_refs (id,sha256,alt_text). Original destination/connection/member/subject/author/credential, review, object versions and attempt remain mandatory. Unknown initialization or publication holds without replay; unknown byte upload permits only exact original image-URN readiness GET. Positively unsent progress needs the original lease; known post URNs permit exact original GET readback. Unavailable read/permission proof remains unavailable. The image path does not refresh tokens or authorize video/document/GIF, replies/chains/retry or legacy OAuth v1/v2 delivery; video and PDF use the separate permissions and paths below.\n\nReviewed Facebook Page plaintext requires posts:facebook; 1–10 assigned certified immutable Library JPEG/PNG images (each at most 10,000,000 bytes) additionally require independent posts:facebook-images and posts:media on the same posts:read and schedule/publish grant. Ordered exact asset IDs, SHA-256, storage versions and reviewed per-image alt text (at most 1000 characters) remain bound to the original Page credential, approved source and original attempt. Image-only caption may be empty. Original acknowledged photo IDs are published in approved order; unknown upload/publication effects hold without replay. Only positively unsent original-lease progress or exact known-post GET readback may recover. Facebook video, chains, delegated retry and legacy OAuth v1/v2 delivery remain held.\n\nReviewed Instagram Reels require independent posts:instagram-video; reviewed JPEG carousels require independent posts:instagram-carousel. Each also requires posts:instagram, posts:media, posts:read and the requested schedule/publish action on the same current grant for the exact account. Descriptors are instagram.approved-video.v1 and instagram.approved-carousel.v1 with existing format=registered_media and exact ordered media_refs. Reels bind one certified assigned MP4/H264 up to 300,000,000 bytes and 3–900 seconds with actual decoded frame/audio/layout evidence, exact embedded original audio, separately certified JPEG cover or original frame offset, and reviewed share_to_feed/audio_name/is_ai_generated options. Carousels bind 2–10 distinct certified assigned JPEGs up to 8,000,000 bytes each, aspect 0.8–1.91 and untrimmed alt text up to 1000 Unicode code points. Empty media captions are valid; normal Juno caption limit remains 2200 UTF-16 units. Both login modes require the original current native subject/creation identity, selected direct or Page credential, finite scopes/expiry, source/review, certificate/object version, command and attempt. Unknown child/parent/publish writes hold without resend; recovery uses original protected inputs, positively unsent progress or exact known-container/media GET, never replacement URLs, refresh or guessed IDs. Requested unavailable observable proof holds. Existing single-JPEG grants gain no P2 permission.\n\nReviewed Instagram caption plus one assigned certified Library JPEG requires independent posts:instagram and posts:media on the same posts:read/schedule-or-publish grant, exact original native login/subject/Page credential and certified object version, original attempt only. Unknown create/publish effects hold without resend; only original known-container progress or exact known-media readback may recover. The single-JPEG permission does not authorize Reels, carousels or Stories; those require the separate opt-ins described here. Caption-only, PNG, replies/chains/retry/legacy OAuth v1/v2 delivery and nonempty unqualified alt/native metadata remain outside this single-JPEG path.\n\nLinkedIn video/PDF: independent posts:linkedin-video or posts:linkedin-document, plus posts:linkedin/posts:media/posts:read and the requested write action. Descriptors linkedin.approved-video.v1 and linkedin.approved-document.v1 bind one original asset and explicit native title/options. Video is certified full-decoded H264 MP4, 75,000–500,000,000 bytes and 3–1800 seconds, preserving original embedded audio and ordered original multipart ranges; optional selected distinct JPEG/PNG cover is separately certified and at most 10 MB. Document is certified unencrypted PDF up to 100,000,000 bytes with a valid bounded 1–300-page tree, explicit title and no cover. Title is 1–400 Unicode characters, separate from commentary. Exact current member/organization destination, native revision/scopes/credential, approved source and original operation remain required. Unknown initialization/publication holds without replay; known original upload/URN progress and exact original readback recover only within the qualified native protocol. Media recovery introduces no credential refresh.\n\nPinterest: posts:pinterest plus independent posts:pinterest-images or posts:pinterest-video, posts:media/posts:read and the write action. Descriptors pinterest.approved-images.v1 and pinterest.approved-video.v1 target the explicitly selected acknowledged local/native board, never an arbitrary first board. PUBLIC or SECRET boards need matching acknowledged ownership; PROTECTED or unproven shared boards hold. Image is one certified JPEG/PNG; video is original certified H264 MP4 plus a separately selected JPEG/PNG cover in reviewed order. Juno bounds each asset to 10,000,000 bytes; video is at least 75,000 bytes and 4–300 seconds. Title, description, required Pin accessibility text, optional HTTPS destination and selected AI disclosure remain exact. media_refs include id,sha256,role,mime_type,file_size,alt_text. Registration/upload/create are original irreversible phases; unknown registration or Pin create without an ID holds. Known registered-media processing and known Pin readback use only the original IDs; no new upload, signed URL or attempt is inferred. Delegated access needs more than 60 seconds of current cached lifetime and is not refreshed.\n\nYouTube: posts:youtube/posts:media/posts:read and the write action. Descriptors youtube.approved-video.v1 and youtube.approved-shorts.v1 bind one original fully decoded H264 MP4, AAC or silent audio, up to 500 MB and 0.5–900 seconds. Shorts eligibility additionally needs square/portrait geometry and at most 180 seconds; it does not establish native Shorts classification. Explicit title, description, tags, category, requested privacy, made-for-kids, synthetic-media disclosure, subscriber notification, delivery_format and consent version youtube-certified-video-20261002-v1 remain reviewed. Required private validation needs private_validation_acknowledged; requested and effective privacy remain distinct, with no silent unapproved conversion. Cover and nonempty alt are held in this path. Original resumable upload recovery reads actual offset and sends only remaining exact bytes; unknown session initialization cannot start another session. Processing/private/unlisted outcomes are not public-publication claims. Fenced original refresh reservations use current credential lease/CAS; a lost exchange acknowledgement cannot be retried automatically.\n\nTikTok: posts:tiktok plus independent posts:tiktok-video or posts:tiktok-photos, posts:media/posts:read and the write action. Descriptors tiktok.approved-video.v1 and tiktok.approved-photos.v1 bind one certified MP4/WebM/QuickTime video or 1–35 ordered certified JPEG/WebP photos. Video is at most 4 GiB, measured 360–4096 pixels per side and 23–60 fps, with supported decoded codecs and actual current creator duration limit. Photos are at most 20 MiB each, short side at most 1080 and long side at most 1920. Explicit privacy, comment/commercial/AI/music choices, content_posting_consent=true and consent_version=juno.tiktok-direct-post.20261002.v1 must match current creator restrictions. Video additionally binds duet/stitch; photos bind automatic-music choice and zero-based cover index. Source photo alt is provenance only, not native per-photo alt. Existing app/private-validation restrictions remain effective without silently changing reviewed privacy. Current video.publish scope and more than 60 seconds of credential lifetime are required; no automatic original refresh. Unknown initialization never resends. Known publish_id permits status-only recovery; it is not a public post ID and completed private outcomes may retain null public IDs.\n\nInstagram Stories: independent posts:instagram-stories plus posts:instagram/posts:media/posts:read and the write action. Descriptors instagram.approved-story-image.v1 and instagram.approved-story-video.v1 bind exactly one assigned certified JPEG up to 8,000,000 bytes or H264 MP4 up to 100,000,000 bytes and 3–60 seconds. Current cached BUSINESS identity is mandatory for the exact Instagram Login or Facebook Login/Page instance, scopes and credential revision/expiry. Canonical native copy is explicitly empty: caption, alt, cover, carousel, first comment and unsupported active options are held, never discarded or converted. The reviewed media_type is STORIES. Original protected review uses instagram_story_image or instagram_story_video roles, exact ID/SHA/storage version/certificate and leased previews. Known original container processing can resume the original publish; known media permits exact original GET readback only. Confirmation matches original owner, IMAGE/VIDEO, native STORY product and finite publication time; no feed permalink is invented.\n\nAll formats retain exact current source/review/fingerprint, original command, native account/subject/connection instance, runtime, scopes, finite authority, deletion and operator gates after awaited work and before each effect. Admission never refreshes providers. Only already qualified original publisher protocols may use fenced refresh/organization checks; their unknown refresh reservations remain held. Unknown upload/create/publish or lost dispatch acknowledgements never authorize a replacement POST, new UUID, new attempt or automatic writer retry. Recovery uses the original command UUID and the matching read operation; known native IDs authorize only the documented original processing/readback protocol. X audio, unqualified Bluesky embeds, unqualified links/GIFs, provider replies/chains beyond selected Threads formats, and format-specific delegated retries stay held. Receipt means normal pipeline admission, not confirmed publication, provider approval or observed live behavior.\n\nReads require posts:read; scheduling requires posts:schedule. Confirm exact currently approved post fingerprints and a schedule 2 minutes to 6 months ahead, strictly before finite grant expiry. Legacy/preparation credentials do not qualify. List uses a post-ID keyset after with limit at most 100, not a snapshot. Original UUID and identical input recover without preflight/lease/enqueue again, including after the original schedule; changed input conflicts. Current post status and provider IDs remain nullable, and removed originals retain only their safe immutable receipts. Controls and retries require their separate qualified permissions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Current candidates, command outcome or immutable scheduling admission", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "grant_id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "scheduled_for": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "audit_id": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "posts:schedule", "posts:publish" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ] }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "required": [ "provider", "account_id", "post_id", "fingerprint" ] }, "minItems": 1, "maxItems": 100 } }, "required": [ "command_id", "workspace_id", "grant_id", "action", "scheduled_for", "input_hash", "audit_id", "created_at", "delegated_actor", "posts" ], "additionalProperties": false }, "posts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "facebook", "bluesky", "linkedin", "x", "instagram", "pinterest", "youtube", "tiktok" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "status": { "type": [ "string", "null" ] }, "scheduled_for": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "provider_post_id": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "delivery_format": { "type": "string", "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1" ] }, "media_refs": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "role": { "type": "string", "enum": [ "image", "video", "cover" ] }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "video/mp4" ] }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "alt_text": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256", "role", "mime_type", "file_size", "alt_text" ], "additionalProperties": false } ] }, "minItems": 0, "maxItems": 35, "description": "Exact ordered certified id/sha256/alt_text refs. Facebook feed video/Reels retain one ref without alt and registered_video/registered_reel respectively. X video retains one ref with absent or empty alt. Bluesky video retains one ref with optional description of at most 2000 Unicode code points, preserved exactly. Independent LinkedIn video/document and YouTube video/Shorts retain one original ref with no nonempty alt. TikTok retains one video or 1–35 ordered photo refs with source alt provenance only. Instagram Stories retain one exact ref with no nonempty alt. Threads interaction descriptors retain no media refs and their original plain-text or text-chain format. Pinterest retains one image or ordered video and cover, including certified role/mime_type/file_size/alt_text. LinkedIn: 1–20 images, alt at most 4086 Unicode characters. X: 1–4 images, alt at most 1000 Unicode characters without trimming. Bluesky multiple images: 2–4 images with required nonempty already-trimmed alt at most 2000 Unicode characters. Descriptor and provider must match; server validates these bounds." } }, "required": [ "provider", "account_id", "post_id", "status", "scheduled_for", "published_at", "provider_post_id", "reason" ] } } }, "required": [ "success", "receipt", "posts" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Unsupported post, schedule or stored preflight; no batch admitted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/create-native-draft": { "post": { "operationId": "createNativeDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Bluesky 2–4 override media refs require nonempty already-trimmed per-image alt of at most 2000 Unicode code points; a single Bluesky video ref accepts optional exact description text up to 2000 Unicode code points. The zero/single-image and larger preparation branches retain their original general 1000 string-unit optional-alt limits. Base assets and other providers remain unchanged. Preparation grants no posts:bluesky-multiple-images authority. Requires its explicit native-drafts action grant; legacy keys and text grants do not qualify. Exact current workspace/accounts and assigned ready media with service-certified SHA-256/storage identity are reauthorized. Uses the normal Composer command and native qualifier. Draft schedule is a preparation intention, never admitted delivery. Immutable command IDs recover creates/edits; changed payload or stale revision conflicts. No automatic write retries, provider refresh, upload, approval or publication. Unsupported owner fields require Composer; no partial disclosure or erasure. Native preview rechecks revision, authority and assets after qualification; publication_authorized is false. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "base_caption": { "type": "string", "maxLength": 100000 }, "caption_variants": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100000 }, "maxItems": 100, "default": [] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "link_preset_id": { "type": "string", "format": "uuid" }, "first_comment": { "type": "string", "maxLength": 100000 }, "variant_strategy": { "type": "string", "enum": [ "identical", "per_cluster", "per_account" ], "default": "identical" }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "overrides": { "type": "object", "properties": { "bluesky": { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "linkedin": { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "pinterest": { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "google_business": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "instagram": { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, "tiktok": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, "threads": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, "facebook": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "x": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "reddit": { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, "snapchat": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "youtube": { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, "discord": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": false }, "schedule": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "specific_time" ] }, "at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "mode", "at" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "next_slot", "best_time" ] } }, "required": [ "mode" ], "additionalProperties": false } ], "default": { "mode": "now" } }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] } }, "required": [ "base_caption", "targets", "workspaceId", "command_id", "confirm" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Scoped native draft, stored preview or immutable command receipt", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "native-drafts:write", "native-drafts:edit" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "native-drafts:write", "native-drafts:edit" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "revision_before": { "type": "integer", "minimum": 0 }, "revision_after": { "type": "integer", "minimum": 0 } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at", "delegated_actor" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "base_caption": { "type": "string", "maxLength": 100000 }, "caption_variants": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100000 }, "maxItems": 100, "default": [] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "link_preset_id": { "type": "string", "format": "uuid" }, "first_comment": { "type": "string", "maxLength": 100000 }, "variant_strategy": { "type": "string", "enum": [ "identical", "per_cluster", "per_account" ], "default": "identical" }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "overrides": { "type": "object", "properties": { "bluesky": { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "linkedin": { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "pinterest": { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "google_business": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "instagram": { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, "tiktok": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, "threads": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, "facebook": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "x": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "reddit": { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, "snapchat": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "youtube": { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, "discord": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": false }, "schedule": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "specific_time" ] }, "at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "mode", "at" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "next_slot", "best_time" ] } }, "required": [ "mode" ], "additionalProperties": false } ], "default": { "mode": "now" } }, "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "parent_recurring_rule_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "base_caption", "targets", "id", "workspace_id", "status", "editorial_revision", "created_at", "updated_at" ], "additionalProperties": false } }, "required": [ "success", "receipt", "draft" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/edit-native-draft": { "post": { "operationId": "editNativeDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Bluesky 2–4 override media refs require nonempty already-trimmed per-image alt of at most 2000 Unicode code points; a single Bluesky video ref accepts optional exact description text up to 2000 Unicode code points. The zero/single-image and larger preparation branches retain their original general 1000 string-unit optional-alt limits. Base assets and other providers remain unchanged. Preparation grants no posts:bluesky-multiple-images authority. Requires its explicit native-drafts action grant; legacy keys and text grants do not qualify. Exact current workspace/accounts and assigned ready media with service-certified SHA-256/storage identity are reauthorized. Uses the normal Composer command and native qualifier. Draft schedule is a preparation intention, never admitted delivery. Immutable command IDs recover creates/edits; changed payload or stale revision conflicts. No automatic write retries, provider refresh, upload, approval or publication. Unsupported owner fields require Composer; no partial disclosure or erasure. Native preview rechecks revision, authority and assets after qualification; publication_authorized is false. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "base_caption": { "type": "string", "maxLength": 100000 }, "caption_variants": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100000 }, "maxItems": 100, "default": [] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "link_preset_id": { "type": "string", "format": "uuid" }, "first_comment": { "type": "string", "maxLength": 100000 }, "variant_strategy": { "type": "string", "enum": [ "identical", "per_cluster", "per_account" ], "default": "identical" }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "overrides": { "type": "object", "properties": { "bluesky": { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "linkedin": { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "pinterest": { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "google_business": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "instagram": { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, "tiktok": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, "threads": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, "facebook": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "x": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "reddit": { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, "snapchat": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "youtube": { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, "discord": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": false }, "schedule": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "specific_time" ] }, "at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "mode", "at" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "next_slot", "best_time" ] } }, "required": [ "mode" ], "additionalProperties": false } ], "default": { "mode": "now" } }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "draft_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "minimum": 0 } }, "required": [ "base_caption", "targets", "workspaceId", "command_id", "confirm", "draft_id", "expected_revision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Scoped native draft, stored preview or immutable command receipt", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "native-drafts:write", "native-drafts:edit" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "native-drafts:write", "native-drafts:edit" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "revision_before": { "type": "integer", "minimum": 0 }, "revision_after": { "type": "integer", "minimum": 0 } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at", "delegated_actor" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "base_caption": { "type": "string", "maxLength": 100000 }, "caption_variants": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100000 }, "maxItems": 100, "default": [] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "link_preset_id": { "type": "string", "format": "uuid" }, "first_comment": { "type": "string", "maxLength": 100000 }, "variant_strategy": { "type": "string", "enum": [ "identical", "per_cluster", "per_account" ], "default": "identical" }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "overrides": { "type": "object", "properties": { "bluesky": { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "linkedin": { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "pinterest": { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "google_business": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "instagram": { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, "tiktok": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, "threads": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, "facebook": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "x": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "reddit": { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, "snapchat": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "youtube": { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, "discord": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": false }, "schedule": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "specific_time" ] }, "at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "mode", "at" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "next_slot", "best_time" ] } }, "required": [ "mode" ], "additionalProperties": false } ], "default": { "mode": "now" } }, "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "parent_recurring_rule_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "base_caption", "targets", "id", "workspace_id", "status", "editorial_revision", "created_at", "updated_at" ], "additionalProperties": false } }, "required": [ "success", "receipt", "draft" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/native-draft": { "get": { "operationId": "readNativeDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Bluesky 2–4 override media refs require nonempty already-trimmed per-image alt of at most 2000 Unicode code points; a single Bluesky video ref accepts optional exact description text up to 2000 Unicode code points. The zero/single-image and larger preparation branches retain their original general 1000 string-unit optional-alt limits. Base assets and other providers remain unchanged. Preparation grants no posts:bluesky-multiple-images authority. Requires its explicit native-drafts action grant; legacy keys and text grants do not qualify. Exact current workspace/accounts and assigned ready media with service-certified SHA-256/storage identity are reauthorized. Uses the normal Composer command and native qualifier. Draft schedule is a preparation intention, never admitted delivery. Immutable command IDs recover creates/edits; changed payload or stale revision conflicts. No automatic write retries, provider refresh, upload, approval or publication. Unsupported owner fields require Composer; no partial disclosure or erasure. Native preview rechecks revision, authority and assets after qualification; publication_authorized is false. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "draft_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Scoped native draft, stored preview or immutable command receipt", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "draft": { "type": "object", "properties": { "base_caption": { "type": "string", "maxLength": 100000 }, "caption_variants": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100000 }, "maxItems": 100, "default": [] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "link_preset_id": { "type": "string", "format": "uuid" }, "first_comment": { "type": "string", "maxLength": 100000 }, "variant_strategy": { "type": "string", "enum": [ "identical", "per_cluster", "per_account" ], "default": "identical" }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "overrides": { "type": "object", "properties": { "bluesky": { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "linkedin": { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "pinterest": { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "google_business": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "instagram": { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, "tiktok": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, "threads": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, "facebook": { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "x": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, "reddit": { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, "snapchat": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, "youtube": { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, "discord": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": false }, "schedule": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "specific_time" ] }, "at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "mode", "at" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "next_slot", "best_time" ] } }, "required": [ "mode" ], "additionalProperties": false } ], "default": { "mode": "now" } }, "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "parent_recurring_rule_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "base_caption", "targets", "id", "workspace_id", "status", "editorial_revision", "created_at", "updated_at" ], "additionalProperties": false }, "editor_path": { "type": "string" }, "command_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "success", "draft", "editor_path", "command_id" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/native-preview": { "get": { "operationId": "previewNativeDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Bluesky 2–4 override media refs require nonempty already-trimmed per-image alt of at most 2000 Unicode code points; a single Bluesky video ref accepts optional exact description text up to 2000 Unicode code points. The zero/single-image and larger preparation branches retain their original general 1000 string-unit optional-alt limits. Base assets and other providers remain unchanged. Preparation grants no posts:bluesky-multiple-images authority. Requires its explicit native-drafts action grant; legacy keys and text grants do not qualify. Exact current workspace/accounts and assigned ready media with service-certified SHA-256/storage identity are reauthorized. Uses the normal Composer command and native qualifier. Draft schedule is a preparation intention, never admitted delivery. Immutable command IDs recover creates/edits; changed payload or stale revision conflicts. No automatic write retries, provider refresh, upload, approval or publication. Unsupported owner fields require Composer; no partial disclosure or erasure. Native preview rechecks revision, authority and assets after qualification; publication_authorized is false. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "draft_id", "in": "query" }, { "schema": { "type": "integer", "minimum": 0 }, "required": true, "name": "expected_revision", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Scoped native draft, stored preview or immutable command receipt", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "draft_id": { "type": "string", "format": "uuid" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "caption": { "type": "string" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "overrides": { "anyOf": [ { "type": "object", "properties": { "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "minLength": 1, "description": "Required nonempty already-trimmed alt text, at most 2000 Unicode code points; preserved exactly without normalization." } }, "required": [ "id", "sha256", "alt_text" ], "additionalProperties": false }, "minItems": 2, "maxItems": 4 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "Optional exact video description, at most 2000 Unicode code points; empty text and whitespace are preserved without normalization. The server requires one certified video, not an image." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 1, "maxItems": 1 }, { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "minItems": 5, "maxItems": 100 } ] }, "alt_text": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, { "type": "object", "properties": { "media_type": { "anyOf": [ { "type": "string", "enum": [ "VIDEO" ] }, { "type": "string", "enum": [ "DOCUMENT" ] } ] }, "title": { "type": "string" }, "cover_asset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 4086 Unicode characters; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, { "type": "object", "properties": { "ai_disclosures": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "link": { "type": "string", "maxLength": 100000 }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "topic_type": { "type": "string", "maxLength": 100000 }, "action_type": { "type": "string", "maxLength": 100000 }, "action_url": { "type": "string", "maxLength": 100000 }, "offer_title": { "type": "string", "maxLength": 100000 }, "offer_start": { "type": "string", "maxLength": 100000 }, "offer_end": { "type": "string", "maxLength": 100000 }, "coupon_code": { "type": "string", "maxLength": 100000 }, "redeem_url": { "type": "string", "maxLength": 100000 }, "terms_conditions": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, { "type": "object", "properties": { "audio_name": { "type": "string", "maxLength": 100000 }, "is_ai_generated": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "media_type": { "type": "string", "enum": [ "IMAGE", "VIDEO", "REELS", "CAROUSEL", "STORIES" ] }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string" } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "alt_text": { "type": "string", "maxLength": 100000 }, "first_comment": { "type": "string", "maxLength": 100000 }, "collaborators": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "location_id": { "type": "string", "maxLength": 100000 }, "product_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "user_tags": { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] }, "maxItems": 100 }, "share_to_facebook": { "type": "boolean" }, "share_to_feed": { "type": "boolean" }, "show_in_reels": { "type": "boolean" }, "also_story": { "type": "boolean" }, "cover_frame_ms": { "type": "integer", "minimum": 0 }, "cover_asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "filename": { "type": "string", "maxLength": 500 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "thumb_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "branded_content_sponsor_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 2 }, "is_paid_partnership": { "type": "boolean" }, "instagram_trial_reels": { "type": "boolean" }, "trial_graduation_strategy": { "type": "string", "enum": [ "MANUAL", "SS_PERFORMANCE" ] }, "native_audio_selection": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } } }, "additionalProperties": false }, { "type": "object", "properties": { "title": { "type": "string", "maxLength": 100000 }, "delivery_mode": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "privacy_level": { "type": "string", "maxLength": 100000 }, "disable_comment": { "type": "boolean" }, "disable_duet": { "type": "boolean" }, "disable_stitch": { "type": "boolean" }, "video_cover_timestamp_ms": { "type": "integer", "minimum": 0 }, "brand_content_toggle": { "type": "boolean" }, "brand_organic_toggle": { "type": "boolean" }, "music_usage_consent": { "type": "boolean" }, "branded_content_consent": { "type": "boolean" }, "photo_title": { "type": "string", "maxLength": 100000 }, "photo_cover_index": { "type": "integer", "minimum": 0 }, "content_posting_consent": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "auto_add_music": { "type": "boolean" }, "is_aigc": { "type": "boolean" } }, "additionalProperties": false }, { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "topic_tag": { "type": "string", "maxLength": 100000 }, "reply_control": { "type": "string", "maxLength": 100000 }, "quote_post_id": { "type": "string", "maxLength": 100000 }, "reply_to_id": { "type": "string", "maxLength": 100000 }, "parent_source": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "thread_chain": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "link_attachment": { "type": "string", "maxLength": 100000 }, "alt_text": { "type": "string", "maxLength": 100000 }, "location_id": { "type": "string", "maxLength": 100000 }, "gif_attachment": { "type": [ "object", "null" ], "properties": { "gif_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "TENOR", "GIPHY" ] } }, "required": [ "gif_id" ], "additionalProperties": false }, "text_attachment": { "type": [ "object", "null" ], "properties": { "plaintext": { "type": "string", "minLength": 1, "maxLength": 10000 }, "link_attachment_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text_with_styling_info": { "type": "array", "items": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 }, "styling_info": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 8 } }, "required": [ "offset", "length", "styling_info" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "plaintext" ], "additionalProperties": false }, "text_spoilers": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "SPOILER" ] }, "offset": { "type": "integer", "minimum": 0 }, "length": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "entity_type", "offset", "length" ], "additionalProperties": false }, "maxItems": 20 }, "is_spoiler_media": { "type": "boolean" }, "reply_approval_mode": { "type": "string", "enum": [ "none", "manual_approval" ] }, "is_ghost_post": { "type": "boolean" } }, "additionalProperties": false }, { "type": "object", "properties": { "media_type": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "mediaType": { "type": "string", "enum": [ "IMAGE", "CAROUSEL", "VIDEO", "REELS" ] }, "caption": { "type": "string", "maxLength": 100000 }, "text": { "type": "string", "maxLength": 100000 }, "message": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "link_og": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "first_comment": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "description": "At most 1000 Unicode characters, preserved exactly without trimming; the server validates code points." } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "poll": { "type": [ "object", "null" ], "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "maxItems": 100 }, { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 100000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } ] } } ] } }, "reply_settings": { "type": "string", "maxLength": 100000 }, "quote_target": { "type": [ "string", "null" ], "maxLength": 100000 }, "made_with_ai": { "type": "boolean" }, "paid_partnership": { "type": "boolean" }, "media_alt_texts": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "thread_chain": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 } }, "additionalProperties": false }, { "type": "object", "properties": { "subreddit": { "type": "string", "maxLength": 100000 }, "handoff_task_id": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "body": { "type": "string", "maxLength": 100000 }, "flair_id": { "type": "string", "maxLength": 100000 }, "nsfw": { "type": "boolean" }, "spoiler": { "type": "boolean" }, "oc": { "type": "boolean" }, "send_replies": { "type": "boolean" }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false }, { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "content_type": { "type": "string", "maxLength": 100000 }, "locale": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "skip_save_to_profile": { "type": "boolean" }, "media_name": { "type": "string", "maxLength": 100000 } }, "additionalProperties": false }, { "type": "object", "properties": { "delivery_format": { "type": "string", "maxLength": 100000 }, "private_validation_acknowledged": { "type": "boolean" }, "consent_version": { "type": "string", "maxLength": 100000 }, "title": { "type": "string", "maxLength": 100000 }, "caption": { "type": "string", "maxLength": 100000 }, "description": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 }, "tags": { "type": "array", "items": { "type": "string", "maxLength": 100000 }, "maxItems": 100 }, "category_id": { "type": "string", "maxLength": 100000 }, "privacy_status": { "type": "string", "maxLength": 100000 }, "made_for_kids": { "type": "boolean" }, "contains_synthetic_media": { "type": "boolean" }, "notify_subscribers": { "type": "boolean" }, "default_language": { "type": "string", "maxLength": 100000 }, "shorts_hashtag": { "type": "boolean" } }, "additionalProperties": false }, { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "additionalProperties": false } ] }, "first_comment": { "type": [ "string", "null" ] }, "thread": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "alt_text": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "text" ], "additionalProperties": false } }, "verdict": { "type": "string", "enum": [ "will", "needs_you", "cannot", "degraded" ] }, "reasons": { "type": "array", "items": { "type": "string" } }, "mutations": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "reason": { "type": "string" }, "from": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "field", "reason", "from", "to" ] } } }, "required": [ "provider", "account_id", "caption", "media", "overrides", "first_comment", "thread", "verdict", "reasons", "mutations" ] } }, "qualification": { "type": "string", "enum": [ "stored_preflight" ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "editor_path": { "type": "string" } }, "required": [ "success", "draft_id", "editorial_revision", "targets", "qualification", "publication_authorized", "editor_path" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/agent-media": { "get": { "operationId": "readAgentMedia", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires explicit media:read agent permission. Lists only workspace-owned assets assigned to current granted destinations, never unassigned Library data or file URLs. All targets and the current grant are reauthorized in the same transaction as the listing. Ready metadata alone is insufficient: usable SHA-256 requires current service byte certification and storage version; unavailable identities remain null with a reason. Native dimensions are certified facts, not owner-supplied metadata. Signed cursors bind grant, target snapshot, exact filters and page size; max 100. No provider refresh, upload or publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,160}$" }, "required": false, "name": "media_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "required": false, "name": "platform", "in": "query" }, { "schema": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "required": false, "name": "account_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Assigned media metadata and qualified identities only", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "account_platform": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "file_name": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "expires_at": { "type": [ "string", "null" ] }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "media_not_ready", "media_expired", "byte_verification_required", null ] }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "file_type": { "type": [ "string", "null" ], "enum": [ "image", "video", "document", null ] }, "mime_type": { "type": [ "string", "null" ] }, "file_size": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "width": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "height": { "type": [ "integer", "null" ], "exclusiveMinimum": 0 }, "duration_ms": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "id", "account_id", "account_platform", "file_name", "status", "created_at", "expires_at", "identity_ready", "reason", "sha256", "file_type", "mime_type", "file_size", "width", "height", "duration_ms" ], "additionalProperties": false }, "maxItems": 100 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] }, "identity_source": { "type": "string", "enum": [ "current_server_certification" ] } }, "required": [ "success", "media", "hasMore", "nextCursor", "identity_source" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/reserve-media-upload": { "post": { "operationId": "reserveAgentMedia", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires explicit media:upload for confirmed reserve/finalize or media:upload-status for original-command recovery. One immutable command binds exact source hash/size/format and granted target. Bounded provisional Storage upload URL; registration reauthorizes and verifies bytes through normal Library registration/certification. JPEG privacy normalization can change stored hash, never source identity. Existing grants/keys gain no scope. Reservation expires within two hours/grant lifetime; Storage URL remains valid for its own two-hour lifetime even after revocation, but revoked grants cannot register. Quota checked again atomically at registration; no guaranteed capacity reservation. Unknown acknowledgement requires original-command recovery, never a new UUID or automatic POST retry. No import, provider refresh or publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "file_name": { "type": "string", "minLength": 1, "maxLength": 255 }, "file_size": { "type": "integer", "minimum": 1, "maximum": 8589934592 }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/gif", "image/webp", "video/mp4", "video/quicktime", "video/webm", "application/pdf" ] } }, "required": [ "workspaceId", "command_id", "confirm", "target", "file_name", "file_size", "source_sha256", "mime_type" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Original intake state and currently usable exact asset, or scoped provisional upload URL", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/finish-media-upload": { "post": { "operationId": "finishAgentMedia", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires explicit media:upload for confirmed reserve/finalize or media:upload-status for original-command recovery. One immutable command binds exact source hash/size/format and granted target. Bounded provisional Storage upload URL; registration reauthorizes and verifies bytes through normal Library registration/certification. JPEG privacy normalization can change stored hash, never source identity. Existing grants/keys gain no scope. Reservation expires within two hours/grant lifetime; Storage URL remains valid for its own two-hour lifetime even after revocation, but revoked grants cannot register. Quota checked again atomically at registration; no guaranteed capacity reservation. Unknown acknowledgement requires original-command recovery, never a new UUID or automatic POST retry. No import, provider refresh or publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] } }, "required": [ "workspaceId", "command_id", "confirm" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Original intake state and currently usable exact asset, or scoped provisional upload URL", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "202": { "description": "Original intake pending exact-byte certification; recover this command with GET media-upload, without replaying finalization. Pending certification does not establish a usable asset.", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/media-upload": { "get": { "operationId": "readAgentMediaIntake", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires explicit media:upload for confirmed reserve/finalize or media:upload-status for original-command recovery. One immutable command binds exact source hash/size/format and granted target. Bounded provisional Storage upload URL; registration reauthorizes and verifies bytes through normal Library registration/certification. JPEG privacy normalization can change stored hash, never source identity. Existing grants/keys gain no scope. Reservation expires within two hours/grant lifetime; Storage URL remains valid for its own two-hour lifetime even after revocation, but revoked grants cannot register. Quota checked again atomically at registration; no guaranteed capacity reservation. Unknown acknowledgement requires original-command recovery, never a new UUID or automatic POST retry. No import, provider refresh or publication. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Original intake state and currently usable exact asset, or scoped provisional upload URL", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/import-media-url": { "post": { "operationId": "importAgentMedia", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires explicit media:import, confirmed exact source SHA-256/size/format, one permitted target and a retained command UUID. Only qualified public platform HTTPS URLs; every socket and redirect is checked. No caller credentials are forwarded. Exact bytes use normal Library URL import/provenance and private certification; JPEG normalization may change stored identity. Full URL query is not retained or returned. One 90-second fetch lease bounds concurrent attempts. 202 is an existing active attempt, not completed registration; GET media-upload with media:upload-status recovers original state. Unknown acknowledgement must retain the original UUID; no automatic POST retry. No publication or provider sync. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "file_name": { "type": "string", "minLength": 1, "maxLength": 255 }, "file_size": { "type": "integer", "minimum": 1, "maximum": 52428800 }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mime_type": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/gif", "image/webp", "video/mp4", "video/quicktime", "video/webm" ] }, "url": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "workspaceId", "command_id", "confirm", "target", "file_name", "file_size", "source_sha256", "mime_type", "url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Recovered or completed canonical URL import", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "202": { "description": "Original intake still has an active fetch lease; not completed registration", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "reserved", "expired", "completed" ] }, "expires_at": { "type": "string" }, "completed_at": { "type": [ "string", "null" ] }, "audit_id": { "type": [ "string", "null" ], "format": "uuid" }, "source_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "stored_sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "sha256": { "type": [ "string", "null" ], "pattern": "^[a-f0-9]{64}$" }, "identity_ready": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "byte_verification_required", null ] } }, "required": [ "id", "sha256", "identity_ready", "reason" ], "additionalProperties": false }, "signed_upload_url": { "type": [ "string", "null" ], "format": "uri" }, "upload_url_expires_at": { "type": [ "string", "null" ] }, "registration_required": { "type": "boolean" }, "quota_reserved": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "certification": { "type": [ "object", "null" ], "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "reason": { "type": [ "string", "null" ], "maxLength": 160 } }, "required": [ "job_id", "status", "reason" ], "additionalProperties": false } }, "required": [ "success", "command_id", "target", "state", "expires_at", "completed_at", "audit_id", "source_sha256", "stored_sha256", "asset", "signed_upload_url", "upload_url_expires_at", "registration_required", "quota_reserved", "publication_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Decoded source bytes differ from the confirmed identity or format", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/composer-draft": { "get": { "operationId": "readComposerDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Read a canonical Composer draft summary using exactly one draft_id or creation command_id. Requires read/admin scope and current workspace ownership. Every explicit target must be a currently owned permitted platform/account; mixed, implicit, group and unsupported targets are unavailable rather than partially disclosed. Reads current caption/status/revision and registered media IDs, not a complete preview, media byte certification or approval. Continue at editor_path in the configured workspace for settings, edits and review. A command lookup recovers an uncertain create without repeating the write; a missing, removed or forbidden draft returns 404 DRAFT_NOT_AVAILABLE. This never authorizes a new creation to resolve uncertainty. 503 READ_UNAVAILABLE permits retrying the same read. No automatic writes or provider calls; only key usage metadata changes. Registered-client OAuth admits this operation only through a fresh explicit policy v2 API registration and owner-selected eligible Threads preparation binding. Exact original grant action, one current owned native Threads target and unscheduled plain text only; no media, options, chains, approval, scheduling, publication or native-draft writes. Original command UUID recovery cannot cross client/binding or API-key origin; current issuer/client/audience/binding/grant/owner/deletion/native identity and token expiry are rechecked in the canonical transaction and before HTTP disclosure. Unknown POST acknowledgement requires original-ID GET recovery with no automatic retry. Existing owner/key contracts remain unchanged. Separately registered hosted MCP v2 tools have their own exact resource/binding and bounded unscheduled Threads text preparation contract; they grant no approval or delivery authority. Hosted activation remains unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "draft_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Current draft summary; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "draft": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "base_caption": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1 }, "media_ids": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "workspace_id", "base_caption", "status", "editorial_revision", "targets", "media_ids", "created_at", "updated_at" ] }, "editor_path": { "type": "string" }, "command_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "draft", "editor_path", "command_id" ] } } } }, "400": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "DRAFT_NOT_AVAILABLE; absent, removed or outside key scope. Never recreate an uncertain command automatically.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "READ_UNAVAILABLE; retry the same read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/create-composer-draft": { "post": { "operationId": "createComposerDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Create only an unscheduled canonical Composer draft. Requires write/admin scope, current workspace ownership and permitted explicit accounts. Confirm exact caption and targets before each call. Persist a command UUID before submission; on uncertain acknowledgement manually retry identical content and command ID. Never automatically retry writes or generate a new command to recover. Same command with changed content returns 409; removed draft returns 410 and cannot be recreated. Receipt is immutable; returned draft is its current safe summary. Expanded/implicit targets after an editor change are rejected on replay; use the scoped draft read for current authorization. Full editor settings and file URLs are not returned. No approval, scheduling or publication. Registered-client OAuth admits this operation only through a fresh explicit policy v2 API registration and owner-selected eligible Threads preparation binding. Exact original grant action, one current owned native Threads target and unscheduled plain text only; no media, options, chains, approval, scheduling, publication or native-draft writes. Original command UUID recovery cannot cross client/binding or API-key origin; current issuer/client/audience/binding/grant/owner/deletion/native identity and token expiry are rechecked in the canonical transaction and before HTTP disclosure. Unknown POST acknowledgement requires original-ID GET recovery with no automatic retry. Existing owner/key contracts remain unchanged. Separately registered hosted MCP v2 tools have their own exact resource/binding and bounded unscheduled Threads text preparation contract; they grant no approval or delivery authority. Hosted activation remains unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "base_caption": { "type": "string", "maxLength": 100000 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] } }, "required": [ "account_id", "provider" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "schedule": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false } }, "required": [ "command_id", "confirm", "workspaceId", "base_caption", "targets" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "Created or replayed immutable receipt and current canonical draft", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "drafts:write" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "drafts:write" ] }, "policy_version": { "type": "number", "enum": [ 2 ] }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id" ], "additionalProperties": false } }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "drafts:write" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "base_caption": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1 }, "media_ids": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "workspace_id", "base_caption", "status", "editorial_revision", "targets", "media_ids", "created_at", "updated_at" ] } }, "required": [ "success", "receipt", "draft" ] } } } }, "400": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "DRAFT_COMMAND_CHANGED: retry must retain exact original payload.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "DRAFT_REMOVED: deleted draft cannot be recreated by replay.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable; no automatic write retry. A transport failure does not establish whether creation succeeded.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/edit-composer-draft": { "post": { "operationId": "editComposerDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Revision-safe replacement of an editable unscheduled text draft. Requires write/admin key scope or explicit drafts:edit agent grant. Retain one stable command_id, draft_id, loaded expected_revision, confirmation and exact text/targets. Current and replacement destinations are reauthorized inside the shared Composer transaction. Richer fields added in the editor cannot be erased by this text-only command. Same immutable command recovers one receipt; a changed command or stale revision returns 409 DRAFT_EDIT_CONFLICT. Recover an uncertain edit with GET composer-draft using its original command_id; no automatic POST retry, scheduling, approval, publication or resurrection. Registered-client OAuth admits this operation only through a fresh explicit policy v2 API registration and owner-selected eligible Threads preparation binding. Exact original grant action, one current owned native Threads target and unscheduled plain text only; no media, options, chains, approval, scheduling, publication or native-draft writes. Original command UUID recovery cannot cross client/binding or API-key origin; current issuer/client/audience/binding/grant/owner/deletion/native identity and token expiry are rechecked in the canonical transaction and before HTTP disclosure. Unknown POST acknowledgement requires original-ID GET recovery with no automatic retry. Existing owner/key contracts remain unchanged. Separately registered hosted MCP v2 tools have their own exact resource/binding and bounded unscheduled Threads text preparation contract; they grant no approval or delivery authority. Hosted activation remains unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "base_caption": { "type": "string", "maxLength": 100000 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] } }, "required": [ "account_id", "provider" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "schedule": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "now" ] } }, "required": [ "mode" ], "additionalProperties": false }, "draft_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "minimum": 0 } }, "required": [ "command_id", "confirm", "workspaceId", "base_caption", "targets", "draft_id", "expected_revision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Immutable edit receipt and current draft summary", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" }, "delegated_actor": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "agent_key" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "drafts:edit" ] }, "policy_version": { "type": "number", "enum": [ 1 ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1 }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "action": { "type": "string", "enum": [ "drafts:edit" ] }, "policy_version": { "type": "number", "enum": [ 2 ] }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id" ], "additionalProperties": false } }, "expires_at": { "type": "string" } }, "required": [ "type", "credential_type", "grant_id", "name", "action", "policy_version", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "targets", "expires_at" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "credential_type": { "type": "string", "enum": [ "oauth" ] }, "policy_version": { "type": "number", "enum": [ 3 ] }, "grant_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "action": { "type": "string", "enum": [ "drafts:edit" ] }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "expires_at": { "type": "string", "format": "date-time" }, "oauth_binding_id": { "type": "string", "format": "uuid" }, "oauth_client_registration_id": { "type": "string", "format": "uuid" }, "oauth_client_id": { "type": "string", "pattern": "^[a-zA-Z0-9._-]{1,160}$" }, "oauth_issuer": { "type": "string", "maxLength": 2048, "format": "uri" }, "oauth_resource": { "type": "string", "maxLength": 2048, "format": "uri" } }, "required": [ "type", "credential_type", "policy_version", "grant_id", "name", "action", "targets", "expires_at", "oauth_binding_id", "oauth_client_registration_id", "oauth_client_id", "oauth_issuer", "oauth_resource" ], "additionalProperties": false } ] }, "revision_before": { "type": "integer", "minimum": 0 }, "revision_after": { "type": "integer", "minimum": 0 } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at", "revision_before", "revision_after" ] }, "draft": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "base_caption": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "held", "committed" ] }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1 }, "media_ids": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "workspace_id", "base_caption", "status", "editorial_revision", "targets", "media_ids", "created_at", "updated_at" ] } }, "required": [ "success", "receipt", "draft" ] } } } }, "400": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. An uncertain acknowledgement requires original-command recovery; never invent a replacement command.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/composer-preview": { "get": { "operationId": "previewComposerDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Revision-bound native text qualification through the same service as Composer preflight, using existing stored account evidence. Requires read/admin key scope or explicit drafts:preview grant, exact currently owned permitted targets and the loaded expected_revision. Includes native caption, reasons and proposed mutations; verdicts never authorize publication and do not establish current live provider readiness. Media, caption variants and threads require the full Composer preview and return 422. Changed/deleted draft during preview returns 409. Does not refresh provider evidence, persist resource changes or call publication adapters. Only the required agent read-admission receipt/key usage metadata changes. Registered-client OAuth admits this operation only through a fresh explicit policy v2 API registration and owner-selected eligible Threads preparation binding. Exact original grant action, one current owned native Threads target and unscheduled plain text only; no media, options, chains, approval, scheduling, publication or native-draft writes. Original command UUID recovery cannot cross client/binding or API-key origin; current issuer/client/audience/binding/grant/owner/deletion/native identity and token expiry are rechecked in the canonical transaction and before HTTP disclosure. Unknown POST acknowledgement requires original-ID GET recovery with no automatic retry. Existing owner/key contracts remain unchanged. Separately registered hosted MCP v2 tools have their own exact resource/binding and bounded unscheduled Threads text preparation contract; they grant no approval or delivery authority. Hosted activation remains unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "draft_id", "in": "query" }, { "schema": { "type": "integer", "minimum": 0 }, "required": true, "name": "expected_revision", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" } ], "responses": { "200": { "description": "Stored native text qualification; publication_authorized is false", "content": { "application/json": { "schema": { "type": "object", "properties": { "draft_id": { "type": "string", "format": "uuid" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string" }, "caption": { "type": "string" }, "verdict": { "type": "string", "enum": [ "will", "needs_you", "cannot", "degraded" ] }, "reasons": { "type": "array", "items": { "type": "string" } }, "mutations": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "reason": { "type": "string" }, "from": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "field", "reason", "from", "to" ] } } }, "required": [ "provider", "account_id", "caption", "verdict", "reasons", "mutations" ] } }, "qualification": { "type": "string", "enum": [ "stored_preflight" ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "editor_path": { "type": "string" } }, "required": [ "draft_id", "editorial_revision", "targets", "qualification", "publication_authorized", "editor_path" ] } } } }, "400": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable preview. Reload changed drafts; repeat only the same read after temporary failure.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/developer/keys": { "get": { "operationId": "listApiKeys", "security": [ { "session": [] } ], "description": "Personal keys belong to the signed-in user across workspaces. workspaceId gates Pro entitlement; it does not bind the key to that workspace. Fresh MFA step-up is required for enrolled users on mutations. Account IDs restrict reads; null means all owned accounts and [] means no accounts. Restricted keys can create a confirmed unscheduled Composer draft for explicit permitted accounts or create/schedule a single Threads text post; other write paths remain unavailable. New bound posts retain an immutable credential and account snapshot, checked at enqueue, execution and each provider write. Expiry must be in the future or null. Rotate by creating a replacement with the same or narrower permissions, installing it, then revoking the old key. The old key remains valid until revoked. Creation id is a client UUID: retries with the same id never mint a second secret; rawKey is returned only once. Revocation retains an inactive identifier so a delayed create retry cannot recreate a revoked key. Revoked keys cannot be reactivated. No plaintext persistence.", "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "workspaceId", "in": "query" } ], "responses": { "200": { "description": "Confirmed result; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "key_prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "allowed_account_ids": { "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "maxItems": 500 }, "is_active": { "type": "boolean" }, "expires_at": { "type": [ "string", "null" ] }, "last_used_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" } }, "required": [ "id", "name", "key_prefix", "scopes", "allowed_account_ids", "is_active", "expires_at", "last_used_at", "created_at" ] } } }, "required": [ "keys" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "createApiKey", "security": [ { "session": [] } ], "description": "Personal keys belong to the signed-in user across workspaces. workspaceId gates Pro entitlement; it does not bind the key to that workspace. Fresh MFA step-up is required for enrolled users on mutations. Account IDs restrict reads; null means all owned accounts and [] means no accounts. Restricted keys can create a confirmed unscheduled Composer draft for explicit permitted accounts or create/schedule a single Threads text post; other write paths remain unavailable. New bound posts retain an immutable credential and account snapshot, checked at enqueue, execution and each provider write. Expiry must be in the future or null. Rotate by creating a replacement with the same or narrower permissions, installing it, then revoking the old key. The old key remains valid until revoked. Creation id is a client UUID: retries with the same id never mint a second secret; rawKey is returned only once. Revocation retains an inactive identifier so a delayed create retry cannot recreate a revoked key. Revoked keys cannot be reactivated. No plaintext persistence.", "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "workspaceId", "in": "query" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "read", "write", "admin" ] }, "minItems": 1, "default": [ "read" ] }, "allowed_account_ids": { "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "maxItems": 500, "default": null }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "name", "expires_at" ] } } } }, "responses": { "200": { "description": "Confirmed result; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "key_prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "allowed_account_ids": { "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "maxItems": 500 }, "is_active": { "type": "boolean" }, "expires_at": { "type": [ "string", "null" ] }, "last_used_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" } }, "required": [ "id", "name", "key_prefix", "scopes", "allowed_account_ids", "is_active", "expires_at", "last_used_at", "created_at" ] }, "rawKey": { "type": "string", "pattern": "^juno_ak_[a-f0-9]{64}$" } }, "required": [ "key", "rawKey" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "put": { "operationId": "updateApiKey", "security": [ { "session": [] } ], "description": "Personal keys belong to the signed-in user across workspaces. workspaceId gates Pro entitlement; it does not bind the key to that workspace. Fresh MFA step-up is required for enrolled users on mutations. Account IDs restrict reads; null means all owned accounts and [] means no accounts. Restricted keys can create a confirmed unscheduled Composer draft for explicit permitted accounts or create/schedule a single Threads text post; other write paths remain unavailable. New bound posts retain an immutable credential and account snapshot, checked at enqueue, execution and each provider write. Expiry must be in the future or null. Rotate by creating a replacement with the same or narrower permissions, installing it, then revoking the old key. The old key remains valid until revoked. Creation id is a client UUID: retries with the same id never mint a second secret; rawKey is returned only once. Revocation retains an inactive identifier so a delayed create retry cannot recreate a revoked key. Revoked keys cannot be reactivated. No plaintext persistence.", "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "id", "in": "query" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "read", "write", "admin" ] }, "minItems": 1 }, "allowed_account_ids": { "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "maxItems": 500 }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" }, "is_active": { "type": "boolean", "enum": [ false ] } } } } } }, "responses": { "200": { "description": "Confirmed result; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "key_prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "allowed_account_ids": { "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,100}$" }, "maxItems": 500 }, "is_active": { "type": "boolean" }, "expires_at": { "type": [ "string", "null" ] }, "last_used_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" } }, "required": [ "id", "name", "key_prefix", "scopes", "allowed_account_ids", "is_active", "expires_at", "last_used_at", "created_at" ] } }, "required": [ "key" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "delete": { "operationId": "revokeApiKey", "security": [ { "session": [] } ], "description": "Personal keys belong to the signed-in user across workspaces. workspaceId gates Pro entitlement; it does not bind the key to that workspace. Fresh MFA step-up is required for enrolled users on mutations. Account IDs restrict reads; null means all owned accounts and [] means no accounts. Restricted keys can create a confirmed unscheduled Composer draft for explicit permitted accounts or create/schedule a single Threads text post; other write paths remain unavailable. New bound posts retain an immutable credential and account snapshot, checked at enqueue, execution and each provider write. Expiry must be in the future or null. Rotate by creating a replacement with the same or narrower permissions, installing it, then revoking the old key. The old key remains valid until revoked. Creation id is a client UUID: retries with the same id never mint a second secret; rawKey is returned only once. Revocation retains an inactive identifier so a delayed create retry cannot recreate a revoked key. Revoked keys cannot be reactivated. No plaintext persistence.", "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "id", "in": "query" } ], "responses": { "200": { "description": "Confirmed result; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "boolean", "enum": [ true ] } }, "required": [ "deleted" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/account-directory": { "get": { "operationId": "readAccountDirectory", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires read/admin scope and current workspace ownership. Returns currently owned, permitted runtime destinations across all 13 provider types; profiles without a runtime binding are not inferred as connected. Account IDs are credential/destination record IDs; use platform plus account_id, or composite identity. Facebook uses its own runtime binding with an owned linked Page profile. Connection and credential health are stored runtime state, not a fresh provider check or write authorization. No credential secrets, raw granted scopes or raw provider receipts are returned. Optional include_operations=true requires an exact platform/account_id pair and returns independent public caller permission and stored account readiness for preparation, preview, history, analytics, inbox, queues, publish and schedule, with current formats/constraints. Default discovery remains identity/health only. Summary is an account prerequisite: content preflight and current reauthorization remain required, publication_authorized is false, provider approval/live execution evidence is separate. Missing/foreign profiles and unavailable inventory fail closed with READ_UNAVAILABLE. Discovery does not expand the qualified platform coverage of posts, drafts, analytics or publishing. Stable provider ascending/provider_account_id ascending keyset pages, limit 1–100; nextCursor is signed to the key, workspace, filters, limit and current key account restriction set, expires after 15 minutes. INVALID_CURSOR requires restarting. Reads are live, not snapshots; concurrent ownership or binding changes may invalidate a page. No provider calls or account mutations; only key usage metadata changes. Legacy /accounts remains unchanged. Registered-client OAuth v1/v2 also admits this GET with its exact corresponding grant action and workspaceId. Current server capability advertisement never supplies authority. Only the fixed configured API resource is accepted; hosted activation is unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "required": false, "name": "platform", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "account_id", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "anyOf": [ { "type": "boolean" }, { "type": "string", "enum": [ "true", "false" ] } ], "description": "Include stored public caller operation gates for one exact platform and account_id; no publication authority" }, "required": false, "description": "Include stored public caller operation gates for one exact platform and account_id; no publication authority", "name": "include_operations", "in": "query" } ], "responses": { "200": { "description": "Authorized account directory; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "workspace_id": { "type": "string" }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "identity": { "type": "string" }, "account_id": { "type": "string", "minLength": 1 }, "platform": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "username": { "type": [ "string", "null" ] }, "display_name": { "type": [ "string", "null" ] }, "connection_state": { "type": "string", "enum": [ "connected", "disconnected", "deleting" ] }, "credential_health": { "type": "string", "enum": [ "healthy", "expiring", "refreshing", "reauth_required", "revoked", "unknown" ] }, "credential_checked_at": { "type": [ "string", "null" ] }, "is_paused": { "type": "boolean" }, "updated_at": { "type": [ "string", "null" ] }, "operations": { "type": "object", "properties": { "version": { "type": "number", "enum": [ 1 ] }, "authority_scope": { "type": "string", "enum": [ "public_api_caller" ] }, "evaluated_at": { "type": "string", "format": "date-time" }, "publication_authorized": { "type": "boolean", "enum": [ false ] }, "content_preflight_required": { "type": "boolean", "enum": [ true ] }, "current_reauthorization_required": { "type": "boolean", "enum": [ true ] }, "normal_formats": { "type": "array", "items": { "type": "string", "enum": [ "text", "image", "video", "carousel", "link" ] } }, "delegated_delivery_formats": { "type": "array", "items": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] } }, "delegated_delivery_lanes": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1 }, "delivery_format": { "type": [ "string", "null" ], "enum": [ "linkedin.approved-images.v1", "linkedin.approved-video.v1", "linkedin.approved-document.v1", "youtube.approved-video.v1", "youtube.approved-shorts.v1", "tiktok.approved-video.v1", "tiktok.approved-photos.v1", "pinterest.approved-images.v1", "pinterest.approved-video.v1", "x.approved-images.v1", "x.approved-video.v1", "facebook.approved-video.v1", "facebook.approved-reels.v1", "bluesky.approved-multiple-images.v1", "bluesky.approved-video.v1", "instagram.approved-video.v1", "instagram.approved-carousel.v1", "instagram.approved-story-image.v1", "instagram.approved-story-video.v1", "threads.approved-poll.v1", "threads.approved-reply.v1", "threads.approved-quote.v1", "threads.approved-interaction-chain.v1", null ] }, "format": { "type": "string", "enum": [ "plain_text", "text_chain", "registered_media", "registered_video", "registered_reel", "registered_media_chain" ] }, "required_actions": { "type": "array", "items": { "type": "string" } }, "publish_permission": { "type": "string", "enum": [ "permitted", "denied", "unsupported" ] }, "schedule_permission": { "type": "string", "enum": [ "permitted", "denied", "unsupported" ] }, "readiness": { "type": "string", "enum": [ "available", "held" ] }, "permission_reasons": { "type": "array", "items": { "type": "string" } }, "reasons": { "type": "array", "items": { "type": "string" } }, "constraints": { "type": "array", "items": { "type": "string" } } }, "required": [ "label", "delivery_format", "format", "required_actions", "publish_permission", "schedule_permission", "readiness", "permission_reasons", "reasons", "constraints" ], "additionalProperties": false }, "maxItems": 8 }, "operations": { "type": "array", "items": { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "prepare", "preview", "history", "analytics", "inbox", "queues", "publish", "schedule" ] }, "permission": { "type": "string", "enum": [ "permitted", "denied", "unsupported" ] }, "readiness": { "type": "string", "enum": [ "available", "held", "handoff" ] }, "permission_reasons": { "type": "array", "items": { "type": "string" } }, "reasons": { "type": "array", "items": { "type": "string" } }, "constraints": { "type": "array", "items": { "type": "string" } } }, "required": [ "operation", "permission", "readiness", "permission_reasons", "reasons", "constraints" ], "additionalProperties": false } } }, "required": [ "version", "authority_scope", "evaluated_at", "publication_authorized", "content_preflight_required", "current_reauthorization_required", "normal_formats", "delegated_delivery_formats", "operations" ], "additionalProperties": false } }, "required": [ "identity", "account_id", "platform", "username", "display_name", "connection_state", "credential_health", "credential_checked_at", "is_paused", "updated_at" ] } }, "nextCursor": { "type": [ "string", "null" ] }, "health_source": { "type": "string", "enum": [ "stored_runtime_state" ] } }, "required": [ "workspace_id", "accounts", "nextCursor", "health_source" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Invalid input, denied authorization or rate limit.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "READ_UNAVAILABLE; retry the same GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/accounts": { "get": { "operationId": "readaccounts", "security": [ { "apiKey": [] } ], "description": "Requires read or admin scope. Ownership and key restrictions are checked on every request. Accounts pages both supported credential tables by stable ID with offset/limit, returning up to 3×limit surfaces (Facebook shares an Instagram credential). Follow next_offset until null. Offsets may shift if accounts are added or removed; maximum offset is 10000. GET is read-only apart from key usage metadata. Missing metrics are null. Capability discovery lists unqualified resources explicitly; legacy routes are not advertised as supported here.", "parameters": [ { "schema": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 10000, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "Confirmed read", "content": { "application/json": { "schema": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "platform": { "type": "string", "enum": [ "threads", "instagram", "facebook" ] }, "username": { "type": [ "string", "null" ] }, "credential_account_id": { "type": "string" }, "follower_count": { "type": [ "number", "null" ] }, "connected_at": { "type": [ "string", "null" ] } }, "required": [ "id", "platform", "username", "follower_count", "connected_at" ] } }, "next_offset": { "type": [ "number", "null" ] } }, "required": [ "accounts", "next_offset" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/capabilities": { "get": { "operationId": "readcapabilities", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires read or admin scope. Ownership and key restrictions are checked on every request. Accounts pages both supported credential tables by stable ID with offset/limit, returning up to 3×limit surfaces (Facebook shares an Instagram credential). Follow next_offset until null. Offsets may shift if accounts are added or removed; maximum offset is 10000. GET is read-only apart from key usage metadata. Missing metrics are null. Capability discovery lists unqualified resources explicitly; legacy routes are not advertised as supported here. Registered-client OAuth v1/v2 also admits this GET with its exact corresponding grant action and workspaceId. Current server capability advertisement never supplies authority. Only the fixed configured API resource is accepted; hosted activation is unobserved. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "responses": { "200": { "description": "Confirmed read", "content": { "application/json": { "schema": { "type": "object", "properties": { "automation": { "type": "object", "properties": { "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "account_id": { "type": "string" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 100 }, "operations": { "type": "array", "items": { "type": "object", "properties": { "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "path": { "type": "string" }, "read": { "type": "boolean" }, "manage": { "type": "boolean" }, "operations": { "type": "array", "items": { "type": "string" } } }, "required": [ "resource", "path", "read", "manage", "operations" ], "additionalProperties": false }, "maxItems": 11 }, "automatic_editorial_approval": { "type": "boolean", "enum": [ false ] } }, "required": [ "workspace_id", "targets", "operations", "automatic_editorial_approval" ], "additionalProperties": false }, "oauth_management": { "type": "object", "properties": { "policy_version": { "type": "number", "enum": [ 3 ] }, "selected_tools": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 100 } }, "required": [ "policy_version", "selected_tools" ], "additionalProperties": false }, "version": { "type": "string", "enum": [ "1" ] }, "contract": { "type": "string" }, "rate_limit": { "type": "object", "properties": { "requests": { "type": "number" }, "window_seconds": { "type": "number" } }, "required": [ "requests", "window_seconds" ] }, "resources": { "type": "object", "additionalProperties": { "type": "object", "properties": { "read": { "type": "boolean" }, "platforms": { "type": "array", "items": { "type": "string" } }, "pagination": { "type": "string" }, "reason": { "type": "string" }, "coverage": { "type": "string" } }, "required": [ "read" ] } }, "account_restricted_writes": { "type": "boolean" }, "restricted_write_paths": { "type": "array", "items": { "type": "string" } } }, "required": [ "version", "contract", "rate_limit", "resources", "account_restricted_writes", "restricted_write_paths" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } }, "parameters": [ { "in": "query", "name": "workspaceId", "required": false, "description": "Exact workspace required for registered-client OAuth; legacy API-key capabilities remain compatible.", "schema": { "type": "string", "minLength": 1 } } ] } }, "/api/v1/posts": { "get": { "operationId": "readposts", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Legacy keys require read/admin scope and current ownership of workspaceId and account credentials. Key account restrictions are intersected on every page. No scheduling/publication side effects; only key usage metadata is updated. Follow nextCursor with the same query and key; signed cursors expire after 15 minutes. INVALID_CURSOR requires restarting from the first page; READ_UNAVAILABLE (503) permits retrying the same GET. Reads are live, not snapshots: concurrent edits may move rows. Posts retain offset support (0–10000), default published status and requested metric/date sorting with stable ID ties and nulls last; total is the first-page count. Queue lists include only queues whose complete target set is allowed. queue_id selects item pages for one visible queue (404 otherwise), ordered by position/post_id; list pages return no items. Mixed-target queues are hidden, not partially disclosed. Changes to the visible queue population invalidate its cursor; restart pagination. Queue pagination reuses the canonical read result and does not promise bounded database scanning. Queue reservations do not prove provider publication. Missing metrics remain null. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "account_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "required": false, "name": "platform", "in": "query" }, { "schema": { "type": "string", "enum": [ "all", "draft", "scheduled", "publishing", "published", "failed", "deleted" ], "default": "published" }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string", "enum": [ "created_at", "published_at", "views_count", "likes_count", "replies_count", "viral_score" ], "default": "created_at" }, "required": false, "name": "sort", "in": "query" }, { "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" }, "required": false, "name": "order", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 10000, "default": 0 }, "required": false, "name": "offset", "in": "query" } ], "responses": { "200": { "description": "Confirmed read; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "posts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "account_id": { "type": [ "string", "null" ] }, "instagram_account_id": { "type": [ "string", "null" ] }, "tiktok_account_id": { "type": [ "string", "null" ] }, "x_account_id": { "type": [ "string", "null" ] }, "snapchat_account_id": { "type": [ "string", "null" ] }, "youtube_account_id": { "type": [ "string", "null" ] }, "bluesky_account_id": { "type": [ "string", "null" ] }, "linkedin_destination_id": { "type": [ "string", "null" ] }, "pinterest_board_id": { "type": [ "string", "null" ] }, "discord_webhook_id": { "type": [ "string", "null" ] }, "google_business_location_id": { "type": [ "string", "null" ] }, "platform": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "youtube", "bluesky", "linkedin", "pinterest", "discord", "google_business", "reddit" ] }, "content": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "scheduled_for": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "views_count": { "type": [ "number", "null" ] }, "likes_count": { "type": [ "number", "null" ] }, "replies_count": { "type": [ "number", "null" ] }, "shares_count": { "type": [ "number", "null" ] }, "viral_score": { "type": [ "number", "null" ] } }, "required": [ "id", "account_id", "instagram_account_id", "tiktok_account_id", "x_account_id", "snapchat_account_id", "youtube_account_id", "platform", "content", "status", "scheduled_for", "published_at", "created_at", "views_count", "likes_count", "replies_count", "shares_count", "viral_score" ] } }, "total": { "type": "integer", "minimum": 0 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] }, "capabilities": { "type": "object", "properties": { "scheduledContentRead": { "type": "boolean", "enum": [ true ] } }, "required": [ "scheduledContentRead" ] } }, "required": [ "posts", "total", "hasMore", "nextCursor", "capabilities" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid cursor traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "METHOD_NOT_ALLOWED; use GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "RATE_LIMITED; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "READ_UNAVAILABLE; retry the same read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/queues": { "get": { "operationId": "readqueues", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Delegated queues:read exposes all thirteen exact destination mappings, including disconnected stored history. Rechecks grant/profile/runtime and returned queue/reservation/native post identities before and after disclosure. QUEUE_IDENTITY_CHANGED (409) discards the result and requires fresh traversal; identity/population changes invalidate cursors. Complete target coverage is required; no private drafts or mutations. Legacy read/admin behavior remains unchanged. Legacy keys require read/admin scope and current ownership of workspaceId and account credentials. Key account restrictions are intersected on every page. No scheduling/publication side effects; only key usage metadata is updated. Follow nextCursor with the same query and key; signed cursors expire after 15 minutes. INVALID_CURSOR requires restarting from the first page; READ_UNAVAILABLE (503) permits retrying the same GET. Reads are live, not snapshots: concurrent edits may move rows. Posts retain offset support (0–10000), default published status and requested metric/date sorting with stable ID ties and nulls last; total is the first-page count. Queue lists include only queues whose complete target set is allowed. queue_id selects item pages for one visible queue (404 otherwise), ordered by position/post_id; list pages return no items. Mixed-target queues are hidden, not partially disclosed. Changes to the visible queue population invalidate its cursor; restart pagination. Queue pagination reuses the canonical read result and does not promise bounded database scanning. Queue reservations do not prove provider publication. Missing metrics remain null. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "queue_id", "in": "query" } ], "responses": { "200": { "description": "Confirmed read; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "queues": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "timezone": { "type": "string" }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string" } }, "required": [ "provider", "account_id" ] } }, "slots": { "type": "array", "items": { "type": "object", "properties": { "day": { "type": "number" }, "time": { "type": "string" } }, "required": [ "day", "time" ] } }, "paused": { "type": "boolean" }, "is_default": { "type": "boolean" }, "revision": { "type": "number" } }, "required": [ "id", "name", "timezone", "targets", "slots", "paused", "is_default", "revision" ] } }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string" }, "queue_id": { "type": "string", "format": "uuid" }, "target": { "type": "string" }, "reserved_for": { "type": "string" }, "position": { "type": "number" }, "content": { "type": [ "string", "null" ] }, "platform": { "type": "string", "enum": [ "bluesky", "linkedin", "pinterest", "google_business", "instagram", "facebook", "threads", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "status": { "type": "string" }, "scheduled_for": { "type": [ "string", "null" ] }, "approval_status": { "type": [ "string", "null" ] }, "submitted": { "type": "boolean" }, "uncertain": { "type": "boolean" } }, "required": [ "post_id", "queue_id", "target", "reserved_for", "position", "content", "platform", "status", "scheduled_for", "approval_status", "submitted", "uncertain" ] } }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "queues", "items", "hasMore", "nextCursor" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid cursor traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "METHOD_NOT_ALLOWED; use GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "409": { "description": "QUEUE_IDENTITY_CHANGED; discard results and restart queue traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "RATE_LIMITED; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "READ_UNAVAILABLE; retry the same read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/media": { "get": { "operationId": "readMedia", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires read/admin scope, current workspace ownership and current account ownership. Returns registered media metadata, not file URLs or current byte certification. Stored SHA-256, size, dimensions, status and expiry are recorded values; ready does not grant publication eligibility. Account-restricted keys see only explicitly assigned media for currently owned permitted account/platform pairs; unassigned, group-only and incomplete assignments are excluded. Unrestricted keys may also read wholly unassigned owned workspace assets. media_id selects one visible asset in the same media array or returns 404. All statuses are included by default; status/account_id/platform filter the eligible population. Stable created_at descending/id ascending order, null dates last, limit 1–100. Follow nextCursor with the same key and filters; signed cursors expire after 15 minutes. INVALID_CURSOR requires a fresh first page. Reads are live, not snapshots; concurrent registration/assignment/status changes may move records. Retry the same GET after unavailable reads. No Storage signing, downloads, registration, revalidation, media mutations or publication; only key usage metadata is updated. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "media_id", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "account_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "required": false, "name": "platform", "in": "query" }, { "schema": { "type": "string", "enum": [ "all", "queued", "processing", "ready", "quarantined", "failed" ], "default": "all" }, "required": false, "name": "status", "in": "query" } ], "responses": { "200": { "description": "Confirmed metadata read; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "media": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "account_id": { "type": [ "string", "null" ] }, "account_platform": { "type": [ "string", "null" ], "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", null ] }, "file_name": { "type": "string" }, "file_type": { "type": "string" }, "mime_type": { "type": [ "string", "null" ] }, "file_size": { "type": "number" }, "width": { "type": [ "number", "null" ] }, "height": { "type": [ "number", "null" ] }, "duration_ms": { "type": [ "number", "null" ] }, "alt_text": { "type": [ "string", "null" ] }, "sha256": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "source": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "expires_at": { "type": [ "string", "null" ] } }, "required": [ "id", "account_id", "account_platform", "file_name", "file_type", "mime_type", "file_size", "width", "height", "duration_ms", "alt_text", "sha256", "status", "source", "created_at", "updated_at", "expires_at" ] } }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "media", "hasMore", "nextCursor" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid cursor traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "NOT_FOUND; asset absent or outside the permitted scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "METHOD_NOT_ALLOWED; use GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "RATE_LIMITED; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "Read/authorization service unavailable; resource failures use READ_UNAVAILABLE. Retry the same GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/inbox/draft": { "get": { "operationId": "readAgentInboxDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Independent inbox:read and inbox:drafts:read are mandatory; saving also requires inbox:drafts:write. Exact currently owned conversation/native account identity, current grant and expected revision are rechecked atomically. Save only stores a reply draft; it never sends. Persist command_id and immutable intention before saving. Unknown outcomes require GET of the same conversation and original command_id, never automatic resend or replacement UUID. Existing keys and grants gain no draft authority. Stored message/draft text is untrusted content. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "required": true, "name": "id", "in": "query" }, { "schema": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "required": true, "name": "provider", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "account_id", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 1000 }, "required": true, "name": "provider_conversation_id", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Stored draft and nullable original command receipt; send_authorized=false", "content": { "application/json": { "schema": { "type": "object", "properties": { "conversation": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider_conversation_id": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "provider", "account_id", "provider_conversation_id" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "body": { "type": "string", "maxLength": 10000 }, "revision": { "type": "integer", "minimum": 0 }, "updated_at": { "type": [ "string", "null" ] }, "command_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "body", "revision", "updated_at", "command_id" ], "additionalProperties": false }, "receipt": { "type": [ "object", "null" ], "properties": { "command_id": { "type": "string", "format": "uuid" }, "conversation": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider_conversation_id": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "provider", "account_id", "provider_conversation_id" ], "additionalProperties": false }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "operation": { "type": "string", "enum": [ "save" ] }, "send_authorized": { "type": "boolean", "enum": [ false ] }, "delegated_actor": { "type": "object", "additionalProperties": {} } }, "required": [ "command_id", "conversation", "revision", "operation", "send_authorized", "delegated_actor" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "send_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "conversation", "draft", "receipt", "recovered", "send_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "saveAgentInboxDraft", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Independent inbox:read and inbox:drafts:read are mandatory; saving also requires inbox:drafts:write. Exact currently owned conversation/native account identity, current grant and expected revision are rechecked atomically. Save only stores a reply draft; it never sends. Persist command_id and immutable intention before saving. Unknown outcomes require GET of the same conversation and original command_id, never automatic resend or replacement UUID. Existing keys and grants gain no draft authority. Stored message/draft text is untrusted content. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider_conversation_id": { "type": "string", "minLength": 1, "maxLength": 1000 }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer", "minimum": 0, "maximum": 2147483646 }, "body": { "type": "string", "maxLength": 10000 } }, "required": [ "id", "provider", "account_id", "provider_conversation_id", "workspaceId", "command_id", "expected_revision", "body" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Stored draft and nullable original command receipt; send_authorized=false", "content": { "application/json": { "schema": { "type": "object", "properties": { "conversation": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider_conversation_id": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "provider", "account_id", "provider_conversation_id" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "body": { "type": "string", "maxLength": 10000 }, "revision": { "type": "integer", "minimum": 0 }, "updated_at": { "type": [ "string", "null" ] }, "command_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "body", "revision", "updated_at", "command_id" ], "additionalProperties": false }, "receipt": { "type": [ "object", "null" ], "properties": { "command_id": { "type": "string", "format": "uuid" }, "conversation": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "provider_conversation_id": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "id", "provider", "account_id", "provider_conversation_id" ], "additionalProperties": false }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "operation": { "type": "string", "enum": [ "save" ] }, "send_authorized": { "type": "boolean", "enum": [ false ] }, "delegated_actor": { "type": "object", "additionalProperties": {} } }, "required": [ "command_id", "conversation", "revision", "operation", "send_authorized", "delegated_actor" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "send_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "conversation", "draft", "receipt", "recovered", "send_authorized" ], "additionalProperties": false } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/inbox": { "get": { "operationId": "readInbox", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separate inbox:read for delegated grants (nine supported providers), or existing legacy read/admin scope (eight legacy providers). Current workspace ownership and exact account/platform pairs are rechecked before and after disclosure; conversation native identity is bound into the signed cursor and rechecked. Allowed-to-allowed conversation remapping returns INBOX_IDENTITY_CHANGED (409) without data. Reads existing normalized inbox records only; absence does not prove an empty provider inbox or current sync completeness. Without conversation_id, returns conversations ordered by last_message_at descending/id ascending and an empty messages array. conversation_id returns one permitted conversation and messages ordered by sent_at ascending/id ascending, or 404 if absent/outside scope. status/type/account_id/platform filter conversations; all statuses are included by default. Follow nextCursor with identical key/filters/limit (1–100); cursors expire after 15 minutes, INVALID_CURSOR requires restarting. Reads are live, not snapshots; changing conversations may move between pages. READ_UNAVAILABLE (503) permits retrying the same GET. Stored edited/deleted timestamps remain nullable. Stored engageable/read_at/status values grant no write authority. Author fields are restricted to id/username/display_name; no cross-account author history is expanded. Attachments reuse the canonical stored projection; available means a syntactically valid stored HTTPS URL, not freshly verified availability. Expired/deleted/unsupported media has no URL; renewal is unsupported. GET never marks messages read, replies, moderates, syncs providers or captures snapshots; only API-key usage metadata changes. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "conversation_id", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": false, "name": "account_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "required": false, "name": "platform", "in": "query" }, { "schema": { "type": "string", "enum": [ "all", "open", "snoozed", "closed", "spam" ], "default": "all" }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string", "enum": [ "comment", "reply", "dm", "mention", "lead" ] }, "required": false, "name": "type", "in": "query" } ], "responses": { "200": { "description": "Confirmed stored inbox read; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "conversations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "discord" ] }, "account_id": { "type": "string" }, "provider_conversation_id": { "type": "string" }, "post_id": { "type": [ "string", "null" ] }, "author": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "display_name": { "type": [ "string", "null" ] } } }, "type": { "type": "string", "enum": [ "comment", "reply", "dm", "mention", "lead" ] }, "sentiment": { "type": [ "string", "null" ] }, "engageable": { "type": "boolean" }, "status": { "type": "string", "enum": [ "open", "snoozed", "closed", "spam" ] }, "labels": { "type": "array", "items": { "type": "string" } }, "read_at": { "type": [ "string", "null" ] }, "snoozed_until": { "type": [ "string", "null" ] }, "last_message_at": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "provider", "account_id", "provider_conversation_id", "post_id", "author", "type", "sentiment", "engageable", "status", "labels", "read_at", "snoozed_until", "last_message_at", "created_at", "updated_at" ] } }, "messages": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "conversation_id": { "type": "string", "format": "uuid" }, "provider_message_id": { "type": "string" }, "reply_to_provider_message_id": { "type": [ "string", "null" ] }, "author": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "username": { "type": [ "string", "null" ] }, "display_name": { "type": [ "string", "null" ] } } }, "body": { "type": [ "string", "null" ] }, "edited_at": { "type": [ "string", "null" ] }, "deleted_at": { "type": [ "string", "null" ] }, "direction": { "type": "string", "enum": [ "inbound", "outbound" ] }, "sent_at": { "type": "string" }, "created_at": { "type": "string" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "file", "share", "unknown" ] }, "label": { "type": "string" }, "renewal": { "type": "string", "enum": [ "unsupported" ] }, "url": { "type": [ "string", "null" ] }, "expires_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "available", "expired", "deleted", "unavailable", "unsupported" ] } }, "required": [ "kind", "label", "renewal", "url", "state" ] } } }, "required": [ "id", "conversation_id", "provider_message_id", "reply_to_provider_message_id", "author", "body", "direction", "sent_at", "created_at", "attachments" ] } }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "conversations", "messages", "hasMore", "nextCursor" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid cursor traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "NOT_FOUND; conversation absent or outside the permitted scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "METHOD_NOT_ALLOWED; use GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "409": { "description": "INBOX_IDENTITY_CHANGED; discard results and restart conversation traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "RATE_LIMITED; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "Read/authorization service unavailable; resource failures use READ_UNAVAILABLE. Retry the same GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/analytics": { "get": { "operationId": "readNativeAnalyticsObservations", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires read/admin scope, current workspace ownership, current owned and permitted platform/account credential, and connected runtime identity. platform and account_id are required. since/until must be offset-aware timestamps in an ordered window no longer than 366 days. Returns immutable native metric_observations rows only, ordered observed_at descending/id descending. Values may be zero; null and non-observed states are preserved. Native provider/surface/metric identity, unit, definition and contract versions, cumulative flag, observation hash, capture/provider windows, measurement/target time, lag and qualification flags remain attached to each fact. Raw provider receipts and credentials are excluded. page_state_counts and page_observed_as_of describe only the returned page. Empty stored history is not zero native performance. provider_completeness is always not_established; no inferred period gains, unique reach or cross-provider totals. Signed cursor follows the same account, key, workspace, window and limit (1–100), expires after 15 minutes and returns INVALID_CURSOR on tamper or scope change. READ_UNAVAILABLE (503) permits retrying the same GET. Reads do not call providers, sync, qualify, backfill or persist analytics evidence; only API-key usage metadata changes. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 4096 }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "action", "in": "query" }, { "schema": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "required": true, "name": "platform", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "account_id", "in": "query" }, { "schema": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "required": true, "name": "since", "in": "query" }, { "schema": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "required": true, "name": "until", "in": "query" } ], "responses": { "200": { "description": "Confirmed stored observation page; Cache-Control: no-store", "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "metric_observations" ] }, "scope": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "platform": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string" }, "since": { "type": "string" }, "until": { "type": "string" } }, "required": [ "workspaceId", "platform", "account_id", "since", "until" ] }, "observations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "platform": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string" }, "post_id": { "type": [ "string", "null" ] }, "provider_account_id": { "type": [ "string", "null" ] }, "provider_content_id": { "type": [ "string", "null" ] }, "surface": { "type": "string" }, "metric_key": { "type": "string" }, "native_api_name": { "type": "string" }, "definition_version": { "type": "string" }, "contract_version": { "type": "string" }, "observation_hash": { "type": "string" }, "value": { "type": [ "number", "null" ] }, "breakdown": {}, "unit": { "type": "string" }, "state": { "type": "string", "enum": [ "observed", "delayed", "not_eligible", "permission_missing", "provider_unsupported", "provider_omitted", "request_failed", "not_synced", "deprecated" ] }, "reason": { "type": [ "string", "null" ] }, "observed_at": { "type": "string" }, "provider_window": { "type": [ "string", "null" ] }, "capture_window": { "type": [ "string", "null" ] }, "target_at": { "type": [ "string", "null" ] }, "lag_seconds": { "type": [ "number", "null" ] }, "live_qualified": { "type": "boolean" }, "cumulative": { "type": "boolean" } }, "required": [ "id", "platform", "account_id", "post_id", "provider_account_id", "provider_content_id", "surface", "metric_key", "native_api_name", "definition_version", "contract_version", "observation_hash", "value", "unit", "state", "reason", "observed_at", "provider_window", "capture_window", "target_at", "lag_seconds", "live_qualified", "cumulative" ] } }, "page_state_counts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "page_observed_as_of": { "type": [ "string", "null" ] }, "provider_completeness": { "type": "string", "enum": [ "not_established" ] }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "source", "scope", "observations", "page_state_counts", "page_observed_as_of", "provider_completeness", "hasMore", "nextCursor" ] } } } }, "400": { "description": "BAD_REQUEST or INVALID_CURSOR; restart invalid cursor traversal.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "401": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "403": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "404": { "description": "NOT_FOUND; account unavailable in this exact scope.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "405": { "description": "METHOD_NOT_ALLOWED; use GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "429": { "description": "RATE_LIMITED; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "500": { "description": "Authorization rejection or unavailable read.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } }, "503": { "description": "Read/authorization service unavailable; resource failures use READ_UNAVAILABLE. Retry the same GET.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error", "code" ] } } } } } } }, "/api/v1/schedule-threads-post": { "post": { "operationId": "scheduleBoundThreadsText", "security": [ { "apiKey": [] } ], "description": "Requires write or admin scope and an owned allowed account. This qualified subset accepts a single Threads text post only: no media, metadata, chains, cross-sharing or other options. Null/omitted scheduledFor creates a draft; scheduling requires 2 minutes to 6 months lead time plus normal billing/preflight/editorial approval. The stored origin and destination cannot be removed or retagged. Revocation, expiry, scope/ownership changes and unsupported later edits block enqueue/execution/provider writes. Creation is not idempotent: do not blindly retry an uncertain POST; reconcile the saved post first. A scheduler failure returns503 with the saved draft postId. This route does not grant editorial approval.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accountId": { "type": "string", "minLength": 1 }, "content": { "type": "string", "minLength": 1 }, "platform": { "type": "string", "enum": [ "threads" ] }, "publishMode": { "type": "string", "enum": [ "auto" ] }, "scheduledFor": { "type": [ "string", "null" ] } }, "required": [ "accountId", "content" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Saved draft or scheduled post; publication is not confirmed", "content": { "application/json": { "schema": { "type": "object", "properties": { "postId": { "type": "string" }, "scheduledFor": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "draft", "scheduled" ] }, "platform": { "type": "string", "enum": [ "threads" ] }, "publishMode": { "type": "string", "enum": [ "auto" ] }, "exactDispatchScheduled": { "type": "boolean" }, "qstashMessageId": { "type": "string" } }, "required": [ "postId", "scheduledFor", "status", "platform", "publishMode", "exactDispatchScheduled" ] } } } }, "400": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Creation ID already exists. The secret cannot be replayed. Refresh, revoke the inaccessible key, then create with a fresh ID.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "100 requests/minute per API key; Retry-After: 60.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "500": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Rejected or unavailable. A network error does not prove a mutation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-portfolio": { "get": { "operationId": "readAutomationAnalyticsPortfolio", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-portfolio:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "after", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "report": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "state": { "type": "string", "enum": [ "reading", "completed" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "result": { "type": [ "object", "null" ], "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.portfolio.v1" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "analytics_supported": { "type": "boolean" }, "reason": { "type": [ "string", "null" ] }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "metric": { "type": "string" }, "basis": { "type": "string", "enum": [ "latest_native_account_observation", "median_stored_content_snapshot" ] }, "value": { "type": [ "number", "null" ] }, "unit": { "type": [ "string", "null" ] }, "definition": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "native_name": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "observed", "unavailable" ] }, "reason": { "type": [ "string", "null" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "missing" ] }, "observed_at": { "type": [ "string", "null" ] }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ], "additionalProperties": false }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "provider", "account_id", "metric", "basis", "value", "unit", "definition", "definition_version", "native_name", "native_window", "native_scope", "state", "reason", "freshness", "observed_at", "coverage", "citation_ids" ], "additionalProperties": false } } }, "required": [ "provider", "account_id", "analytics_supported", "reason", "facts" ], "additionalProperties": false } }, "citations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string", "enum": [ "juno.analytics.read.v1" ] }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "content_id": { "type": [ "string", "null" ] }, "metric": { "type": "string" }, "native_name": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "surface": { "type": [ "string", "null" ] }, "capture_window": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "observed_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "required": [ "id", "source", "provider", "account_id", "content_id", "metric", "native_name", "definition_version", "surface", "capture_window", "native_window", "native_scope", "observed_at", "unit", "value" ], "additionalProperties": false } }, "comparisons": { "type": "array", "items": { "type": "object", "properties": { "fact_ids": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ] }, "difference": { "type": "number" }, "unit": { "type": "string" }, "text": { "type": "string" } }, "required": [ "fact_ids", "difference", "unit", "text" ], "additionalProperties": false } }, "explanations": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "finding", "recommendation", "coverage" ] }, "text": { "type": "string" }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "text", "citation_ids" ], "additionalProperties": false } }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "captured_at", "selection", "accounts", "citations", "comparisons", "explanations", "provider_refresh", "model_transfer" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "state", "selection", "created_at", "result" ], "additionalProperties": false } }, "required": [ "report" ], "additionalProperties": false }, { "type": "object", "properties": { "reports": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "state": { "type": "string", "enum": [ "reading", "completed" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "result": { "type": [ "object", "null" ], "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.portfolio.v1" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "analytics_supported": { "type": "boolean" }, "reason": { "type": [ "string", "null" ] }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "metric": { "type": "string" }, "basis": { "type": "string", "enum": [ "latest_native_account_observation", "median_stored_content_snapshot" ] }, "value": { "type": [ "number", "null" ] }, "unit": { "type": [ "string", "null" ] }, "definition": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "native_name": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "observed", "unavailable" ] }, "reason": { "type": [ "string", "null" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "missing" ] }, "observed_at": { "type": [ "string", "null" ] }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ], "additionalProperties": false }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "provider", "account_id", "metric", "basis", "value", "unit", "definition", "definition_version", "native_name", "native_window", "native_scope", "state", "reason", "freshness", "observed_at", "coverage", "citation_ids" ], "additionalProperties": false } } }, "required": [ "provider", "account_id", "analytics_supported", "reason", "facts" ], "additionalProperties": false } }, "citations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string", "enum": [ "juno.analytics.read.v1" ] }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "content_id": { "type": [ "string", "null" ] }, "metric": { "type": "string" }, "native_name": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "surface": { "type": [ "string", "null" ] }, "capture_window": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "observed_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "required": [ "id", "source", "provider", "account_id", "content_id", "metric", "native_name", "definition_version", "surface", "capture_window", "native_window", "native_scope", "observed_at", "unit", "value" ], "additionalProperties": false } }, "comparisons": { "type": "array", "items": { "type": "object", "properties": { "fact_ids": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ] }, "difference": { "type": "number" }, "unit": { "type": "string" }, "text": { "type": "string" } }, "required": [ "fact_ids", "difference", "unit", "text" ], "additionalProperties": false } }, "explanations": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "finding", "recommendation", "coverage" ] }, "text": { "type": "string" }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "text", "citation_ids" ], "additionalProperties": false } }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "captured_at", "selection", "accounts", "citations", "comparisons", "explanations", "provider_refresh", "model_transfer" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "state", "selection", "created_at", "result" ], "additionalProperties": false }, "maxItems": 50 }, "next_after": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "reports", "next_after" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsPortfolio", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-portfolio:read and automation:analytics-portfolio:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: prepare, remove. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "prepare" ] }, "id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "operation", "id", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "remove" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "report": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "state": { "type": "string", "enum": [ "reading", "completed" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "result": { "type": [ "object", "null" ], "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.portfolio.v1" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "analytics_supported": { "type": "boolean" }, "reason": { "type": [ "string", "null" ] }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "metric": { "type": "string" }, "basis": { "type": "string", "enum": [ "latest_native_account_observation", "median_stored_content_snapshot" ] }, "value": { "type": [ "number", "null" ] }, "unit": { "type": [ "string", "null" ] }, "definition": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "native_name": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "observed", "unavailable" ] }, "reason": { "type": [ "string", "null" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "missing" ] }, "observed_at": { "type": [ "string", "null" ] }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ], "additionalProperties": false }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "provider", "account_id", "metric", "basis", "value", "unit", "definition", "definition_version", "native_name", "native_window", "native_scope", "state", "reason", "freshness", "observed_at", "coverage", "citation_ids" ], "additionalProperties": false } } }, "required": [ "provider", "account_id", "analytics_supported", "reason", "facts" ], "additionalProperties": false } }, "citations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string", "enum": [ "juno.analytics.read.v1" ] }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "content_id": { "type": [ "string", "null" ] }, "metric": { "type": "string" }, "native_name": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "surface": { "type": [ "string", "null" ] }, "capture_window": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "observed_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "required": [ "id", "source", "provider", "account_id", "content_id", "metric", "native_name", "definition_version", "surface", "capture_window", "native_window", "native_scope", "observed_at", "unit", "value" ], "additionalProperties": false } }, "comparisons": { "type": "array", "items": { "type": "object", "properties": { "fact_ids": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ] }, "difference": { "type": "number" }, "unit": { "type": "string" }, "text": { "type": "string" } }, "required": [ "fact_ids", "difference", "unit", "text" ], "additionalProperties": false } }, "explanations": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "finding", "recommendation", "coverage" ] }, "text": { "type": "string" }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "text", "citation_ids" ], "additionalProperties": false } }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "captured_at", "selection", "accounts", "citations", "comparisons", "explanations", "provider_refresh", "model_transfer" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "state", "selection", "created_at", "result" ], "additionalProperties": false } }, "required": [ "report" ], "additionalProperties": false }, { "type": "object", "properties": { "reports": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "state": { "type": "string", "enum": [ "reading", "completed" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "result": { "type": [ "object", "null" ], "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.portfolio.v1" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "analytics_supported": { "type": "boolean" }, "reason": { "type": [ "string", "null" ] }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "metric": { "type": "string" }, "basis": { "type": "string", "enum": [ "latest_native_account_observation", "median_stored_content_snapshot" ] }, "value": { "type": [ "number", "null" ] }, "unit": { "type": [ "string", "null" ] }, "definition": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "native_name": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "observed", "unavailable" ] }, "reason": { "type": [ "string", "null" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "missing" ] }, "observed_at": { "type": [ "string", "null" ] }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ], "additionalProperties": false }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "provider", "account_id", "metric", "basis", "value", "unit", "definition", "definition_version", "native_name", "native_window", "native_scope", "state", "reason", "freshness", "observed_at", "coverage", "citation_ids" ], "additionalProperties": false } } }, "required": [ "provider", "account_id", "analytics_supported", "reason", "facts" ], "additionalProperties": false } }, "citations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string", "enum": [ "juno.analytics.read.v1" ] }, "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string" }, "content_id": { "type": [ "string", "null" ] }, "metric": { "type": "string" }, "native_name": { "type": [ "string", "null" ] }, "definition_version": { "type": [ "string", "null" ] }, "surface": { "type": [ "string", "null" ] }, "capture_window": { "type": [ "string", "null" ] }, "native_window": { "type": [ "string", "null" ] }, "native_scope": { "type": [ "string", "null" ] }, "observed_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "unit": { "type": "string" }, "value": { "type": "number" } }, "required": [ "id", "source", "provider", "account_id", "content_id", "metric", "native_name", "definition_version", "surface", "capture_window", "native_window", "native_scope", "observed_at", "unit", "value" ], "additionalProperties": false } }, "comparisons": { "type": "array", "items": { "type": "object", "properties": { "fact_ids": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ] }, "difference": { "type": "number" }, "unit": { "type": "string" }, "text": { "type": "string" } }, "required": [ "fact_ids", "difference", "unit", "text" ], "additionalProperties": false } }, "explanations": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "finding", "recommendation", "coverage" ] }, "text": { "type": "string" }, "citation_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "text", "citation_ids" ], "additionalProperties": false } }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "captured_at", "selection", "accounts", "citations", "comparisons", "explanations", "provider_refresh", "model_transfer" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "state", "selection", "created_at", "result" ], "additionalProperties": false }, "maxItems": 50 }, "next_after": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "reports", "next_after" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-skills": { "get": { "operationId": "readAutomationAnalyticsSkills", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-skills:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "skill_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "version_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "required": false, "name": "trigger", "in": "query" }, { "schema": { "type": "string", "enum": [ "preview", "suggestion" ] }, "required": false, "name": "view", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "source_run_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "none", "skill" ] }, "required": false, "name": "manual", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "revise", "retire" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "admission": { "type": "string", "enum": [ "created", "revised", "retired" ] } }, "required": [ "command_id", "operation", "skill_id", "version_id", "admission" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "skill": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false } }, "required": [ "receipt", "recovered", "skill" ], "additionalProperties": false }, { "type": "object", "properties": { "skill": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false } }, "required": [ "skill" ], "additionalProperties": false }, { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "skills" ], "additionalProperties": false }, { "type": "object", "properties": { "skill": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "current", "superseded", "retired" ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "title", "brief", "state", "consent_version", "transfer_authorized", "snapshot_sha256" ], "additionalProperties": false }, "message": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "user" ] }, "content": { "type": "string", "minLength": 1, "maxLength": 12000 } }, "required": [ "role", "content" ], "additionalProperties": false } }, "required": [ "skill", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "format": { "type": "string", "enum": [ "analysis", "text" ] }, "status": { "type": "string", "enum": [ "suggested", "choice_required", "no_skill", "manual" ] }, "selected": { "type": [ "object", "null" ], "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "explanation_code": { "type": "string", "enum": [ "declared_task_and_scope", "manual_selection" ] }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "skill_id", "version_id", "title", "priority", "snapshot_sha256", "explanation_code", "explanation" ], "additionalProperties": false }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "explanation_code": { "type": "string", "enum": [ "declared_task_and_scope", "manual_selection" ] }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "skill_id", "version_id", "title", "priority", "snapshot_sha256", "explanation_code", "explanation" ], "additionalProperties": false }, "maxItems": 32 }, "reason_code": { "type": "string", "enum": [ "manual_no_skill", "manual_selection", "unique_highest_priority", "equal_highest_priority", "no_eligible_match" ] }, "effect": { "type": "string", "enum": [ "none" ] }, "transfer_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "source_run_id", "trigger", "format", "status", "selected", "candidates", "reason_code", "effect", "transfer_authorized" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsSkills", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-skills:read and automation:analytics-skills:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: create, revise, retire. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "operation": { "type": "string", "enum": [ "create" ] }, "command_id": { "type": "string", "format": "uuid" }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "title", "brief", "triggers", "priority", "operation", "command_id", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "operation": { "type": "string", "enum": [ "revise" ] }, "command_id": { "type": "string", "format": "uuid" }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "expected_version_id": { "type": "string", "format": "uuid" } }, "required": [ "title", "brief", "triggers", "priority", "operation", "command_id", "skill_id", "version_id", "expected_version_id" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "retire" ] }, "command_id": { "type": "string", "format": "uuid" }, "skill_id": { "type": "string", "format": "uuid" }, "expected_version_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "command_id", "skill_id", "expected_version_id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "revise", "retire" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "admission": { "type": "string", "enum": [ "created", "revised", "retired" ] } }, "required": [ "command_id", "operation", "skill_id", "version_id", "admission" ], "additionalProperties": false }, "recovered": { "type": "boolean" }, "skill": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false } }, "required": [ "receipt", "recovered", "skill" ], "additionalProperties": false }, { "type": "object", "properties": { "skill": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false } }, "required": [ "skill" ], "additionalProperties": false }, { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "author_user_id": { "type": "string", "format": "uuid" }, "current_version_id": { "type": "string", "format": "uuid" }, "retired_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "triggers": { "type": "array", "items": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "minItems": 1, "maxItems": 2 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "matching": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "minItems": 1, "maxItems": 8 }, "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 32 }, "formats": { "type": "array", "items": { "type": "string", "enum": [ "analysis", "text" ] }, "minItems": 1, "maxItems": 2 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "explanation" ], "additionalProperties": false }, "id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "minimum": 1, "maximum": 64 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "title", "brief", "triggers", "priority", "id", "revision", "snapshot_sha256", "created_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 } }, "required": [ "id", "workspace_id", "author_user_id", "current_version_id", "retired_at", "created_at", "versions" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "skills" ], "additionalProperties": false }, { "type": "object", "properties": { "skill": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "brief": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "current", "superseded", "retired" ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "title", "brief", "state", "consent_version", "transfer_authorized", "snapshot_sha256" ], "additionalProperties": false }, "message": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "user" ] }, "content": { "type": "string", "minLength": 1, "maxLength": 12000 } }, "required": [ "role", "content" ], "additionalProperties": false } }, "required": [ "skill", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "format": { "type": "string", "enum": [ "analysis", "text" ] }, "status": { "type": "string", "enum": [ "suggested", "choice_required", "no_skill", "manual" ] }, "selected": { "type": [ "object", "null" ], "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "explanation_code": { "type": "string", "enum": [ "declared_task_and_scope", "manual_selection" ] }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "skill_id", "version_id", "title", "priority", "snapshot_sha256", "explanation_code", "explanation" ], "additionalProperties": false }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "priority": { "type": "integer", "minimum": 0, "maximum": 100 }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "explanation_code": { "type": "string", "enum": [ "declared_task_and_scope", "manual_selection" ] }, "explanation": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "skill_id", "version_id", "title", "priority", "snapshot_sha256", "explanation_code", "explanation" ], "additionalProperties": false }, "maxItems": 32 }, "reason_code": { "type": "string", "enum": [ "manual_no_skill", "manual_selection", "unique_highest_priority", "equal_highest_priority", "no_eligible_match" ] }, "effect": { "type": "string", "enum": [ "none" ] }, "transfer_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "source_run_id", "trigger", "format", "status", "selected", "candidates", "reason_code", "effect", "transfer_authorized" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-skill-preparation": { "get": { "operationId": "readAutomationAnalyticsSkillPreparation", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-skill-preparation:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "policy_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "run" ] }, "required": false, "name": "view", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "policy_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "choose", "pause", "resume", "revoke", "cancel" ] }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "policy_id", "operation", "revision" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "policies" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsSkillPreparation", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-skill-preparation:read and automation:analytics-skill-preparation:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: create, choose, continue, pause, resume, cancel, revoke. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "operation": { "type": "string", "enum": [ "create" ] }, "policy_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at", "operation", "policy_id", "command_id" ], "additionalProperties": false }, { "type": "object", "properties": { "policy_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "pause", "resume", "revoke", "cancel" ] } }, "required": [ "policy_id", "command_id", "expected_revision", "operation" ], "additionalProperties": false }, { "type": "object", "properties": { "policy_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "choose" ] }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "policy_id", "command_id", "expected_revision", "operation", "choice" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "continue" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "policy_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "choose", "pause", "resume", "revoke", "cancel" ] }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "policy_id", "operation", "revision" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "policies" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-skill-recurring-preparation": { "get": { "operationId": "readAutomationAnalyticsSkillRecurringPreparation", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-skill-recurring-preparation:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "recurring_policy_id": { "type": "string", "format": "uuid" }, "expected_parent_definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "first_ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "future_skill_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "future_skill_consent_version": { "type": "string", "enum": [ "analytics-skill-recurring-preparation-20261002-v1" ] }, "future_draft_save_authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "recurring_policy_id", "expected_parent_definition_sha256", "first_ordinal", "max_occurrences", "expires_at", "accepted_skills", "allow_no_skill", "future_skill_transfer_authorized", "future_skill_consent_version", "future_draft_save_authorized" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "parent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "expires_at": { "type": "string" } }, "required": [ "id", "definition_sha256", "paused", "revoked_at", "expires_at" ], "additionalProperties": false }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "parent_paused", "revoked", "parent_revoked", "expired", "parent_expired", null ] }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "occurrence_id": { "type": [ "string", "null" ], "format": "uuid" }, "ask_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "tool_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "session_policy_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "cancelled_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "planned", "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "hold": { "type": [ "string", "null" ], "enum": [ "not_due", "window_missed", "cancelled", "attempt_held", "dst_gap", null ] }, "session": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "ordinal", "local_due", "due_at", "occurrence_id", "ask_run_id", "tool_run_id", "session_policy_id", "draft_command_id", "cancelled_at", "state", "hold", "session" ], "additionalProperties": false }, "maxItems": 4 }, "brand_future_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "version", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "created_at", "choice", "parent", "hold", "occurrences", "brand_future_transfer", "scheduled", "publication_authorized" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "policy_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "pause", "resume", "revoke", "choose", "cancel" ] }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "policy_id", "operation", "revision" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "recurring_policy_id": { "type": "string", "format": "uuid" }, "expected_parent_definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "first_ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "future_skill_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "future_skill_consent_version": { "type": "string", "enum": [ "analytics-skill-recurring-preparation-20261002-v1" ] }, "future_draft_save_authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "recurring_policy_id", "expected_parent_definition_sha256", "first_ordinal", "max_occurrences", "expires_at", "accepted_skills", "allow_no_skill", "future_skill_transfer_authorized", "future_skill_consent_version", "future_draft_save_authorized" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "parent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "expires_at": { "type": "string" } }, "required": [ "id", "definition_sha256", "paused", "revoked_at", "expires_at" ], "additionalProperties": false }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "parent_paused", "revoked", "parent_revoked", "expired", "parent_expired", null ] }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "occurrence_id": { "type": [ "string", "null" ], "format": "uuid" }, "ask_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "tool_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "session_policy_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "cancelled_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "planned", "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "hold": { "type": [ "string", "null" ], "enum": [ "not_due", "window_missed", "cancelled", "attempt_held", "dst_gap", null ] }, "session": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "ordinal", "local_due", "due_at", "occurrence_id", "ask_run_id", "tool_run_id", "session_policy_id", "draft_command_id", "cancelled_at", "state", "hold", "session" ], "additionalProperties": false }, "maxItems": 4 }, "brand_future_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "version", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "created_at", "choice", "parent", "hold", "occurrences", "brand_future_transfer", "scheduled", "publication_authorized" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "policies" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsSkillRecurringPreparation", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-skill-recurring-preparation:read and automation:analytics-skill-recurring-preparation:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: create, choose, pause, resume, cancel, revoke. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "recurring_policy_id": { "type": "string", "format": "uuid" }, "expected_parent_definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "first_ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "future_skill_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "future_skill_consent_version": { "type": "string", "enum": [ "analytics-skill-recurring-preparation-20261002-v1" ] }, "future_draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "operation": { "type": "string", "enum": [ "create" ] }, "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" } }, "required": [ "recurring_policy_id", "expected_parent_definition_sha256", "first_ordinal", "max_occurrences", "expires_at", "accepted_skills", "allow_no_skill", "future_skill_transfer_authorized", "future_skill_consent_version", "future_draft_save_authorized", "operation", "id", "command_id" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "pause", "resume", "revoke" ] }, "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id", "command_id", "expected_revision" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "choose" ] }, "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "operation", "id", "command_id", "expected_revision", "choice" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "cancel" ] }, "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 } }, "required": [ "operation", "id", "command_id", "expected_revision", "ordinal" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "policy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "recurring_policy_id": { "type": "string", "format": "uuid" }, "expected_parent_definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "first_ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "future_skill_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "future_skill_consent_version": { "type": "string", "enum": [ "analytics-skill-recurring-preparation-20261002-v1" ] }, "future_draft_save_authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "recurring_policy_id", "expected_parent_definition_sha256", "first_ordinal", "max_occurrences", "expires_at", "accepted_skills", "allow_no_skill", "future_skill_transfer_authorized", "future_skill_consent_version", "future_draft_save_authorized" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "parent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "expires_at": { "type": "string" } }, "required": [ "id", "definition_sha256", "paused", "revoked_at", "expires_at" ], "additionalProperties": false }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "parent_paused", "revoked", "parent_revoked", "expired", "parent_expired", null ] }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "occurrence_id": { "type": [ "string", "null" ], "format": "uuid" }, "ask_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "tool_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "session_policy_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "cancelled_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "planned", "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "hold": { "type": [ "string", "null" ], "enum": [ "not_due", "window_missed", "cancelled", "attempt_held", "dst_gap", null ] }, "session": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "ordinal", "local_due", "due_at", "occurrence_id", "ask_run_id", "tool_run_id", "session_policy_id", "draft_command_id", "cancelled_at", "state", "hold", "session" ], "additionalProperties": false }, "maxItems": 4 }, "brand_future_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "version", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "created_at", "choice", "parent", "hold", "occurrences", "brand_future_transfer", "scheduled", "publication_authorized" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "policy_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "pause", "resume", "revoke", "choose", "cancel" ] }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "policy_id", "operation", "revision" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "policy" ], "additionalProperties": false }, { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "recurring_policy_id": { "type": "string", "format": "uuid" }, "expected_parent_definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "first_ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] }, "future_skill_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "future_skill_consent_version": { "type": "string", "enum": [ "analytics-skill-recurring-preparation-20261002-v1" ] }, "future_draft_save_authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "recurring_policy_id", "expected_parent_definition_sha256", "first_ordinal", "max_occurrences", "expires_at", "accepted_skills", "allow_no_skill", "future_skill_transfer_authorized", "future_skill_consent_version", "future_draft_save_authorized" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "choice": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "parent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "expires_at": { "type": "string" } }, "required": [ "id", "definition_sha256", "paused", "revoked_at", "expires_at" ], "additionalProperties": false }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "parent_paused", "revoked", "parent_revoked", "expired", "parent_expired", null ] }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "occurrence_id": { "type": [ "string", "null" ], "format": "uuid" }, "ask_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "tool_run_id": { "type": [ "string", "null" ], "format": "uuid" }, "session_policy_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "cancelled_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "planned", "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "hold": { "type": [ "string", "null" ], "enum": [ "not_due", "window_missed", "cancelled", "attempt_held", "dst_gap", null ] }, "session": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "actor_user_id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "draft_command_id": { "type": "string", "format": "uuid" }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 512 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "accepted_skills": { "type": "array", "items": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "maxItems": 32 }, "allow_no_skill": { "type": "boolean" }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "draft_save_authorized": { "type": "boolean", "enum": [ true ] }, "preparation_consent_version": { "type": "string", "enum": [ "analytics-skill-preparation-session-20261002-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "manual": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false } ] } }, "required": [ "source_run_id", "run_id", "draft_command_id", "objective", "target", "accepted_skills", "allow_no_skill", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "draft_save_authorized", "preparation_consent_version", "expires_at" ], "additionalProperties": false }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "created_at": { "type": "string" }, "selection": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "none" ] } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "skill" ] }, "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "skill_id", "version_id" ], "additionalProperties": false }, { "type": "null" } ] }, "hold": { "type": [ "string", "null" ], "enum": [ "choice_required", "no_eligible_skill", "skill_version_changed", "paused", "revoked", "cancelled", "expired", "attempt_held", "no_proposal", null ] }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "draft": { "type": [ "object", "null" ], "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "cancelled_at", "created_at", "selection", "hold", "run", "draft" ], "additionalProperties": false } }, "required": [ "ordinal", "local_due", "due_at", "occurrence_id", "ask_run_id", "tool_run_id", "session_policy_id", "draft_command_id", "cancelled_at", "state", "hold", "session" ], "additionalProperties": false }, "maxItems": 4 }, "brand_future_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "version", "workspace_id", "actor_user_id", "revision", "definition", "paused", "revoked_at", "created_at", "choice", "parent", "hold", "occurrences", "brand_future_transfer", "scheduled", "publication_authorized" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "policies" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/media-draft-plan": { "get": { "operationId": "readAutomationMediaDraftPlan", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:media-draft-plan:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "plan": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired", "completed" ] }, "created_at": { "type": "string" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "media-draft-preparation-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "entries": { "type": "array", "items": { "type": "object", "properties": { "entry_id": { "type": "string" }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "asset": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "file_name": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "width": { "type": "integer", "exclusiveMinimum": 0 }, "height": { "type": "integer", "exclusiveMinimum": 0 }, "expires_at": { "type": [ "string", "null" ] }, "last_used_at": { "type": [ "string", "null" ] }, "rights_state": { "type": "string", "enum": [ "unavailable" ] }, "recent_use_state": { "type": "string", "enum": [ "recorded", "unavailable" ] } }, "required": [ "id", "provider", "account_id", "file_name", "sha256", "mime_type", "file_size", "width", "height", "expires_at", "last_used_at", "rights_state", "recent_use_state" ], "additionalProperties": false }, "proposed_local_day": { "type": "string" }, "goal": { "type": "string" }, "reason": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "saved" ] }, "approval": { "type": [ "object", "null" ], "properties": { "entry_id": { "type": "string", "pattern": "^entry-\\d+$" }, "caption": { "type": "string", "minLength": 1, "maxLength": 300 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "entry_id", "caption", "alt_text" ], "additionalProperties": false }, "draft_id": { "type": [ "string", "null" ], "format": "uuid" }, "receipt": { "type": [ "object", "null" ], "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ], "additionalProperties": false } }, "required": [ "entry_id", "command_id", "target", "asset", "proposed_local_day", "goal", "reason", "state", "approval", "draft_id", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "holds": { "type": "array", "items": { "type": "object", "properties": { "asset_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "reason": { "type": "string" } }, "required": [ "asset_id", "reason" ], "additionalProperties": false }, "maxItems": 50 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "result_adaptation": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false }, "comparison": { "type": [ "object", "null" ], "properties": { "text_median_views": { "type": "number", "minimum": 0 }, "single_image_median_views": { "type": "number", "minimum": 0 }, "absolute_delta": { "type": "number" }, "relative_delta_percent": { "type": [ "number", "null" ] } }, "required": [ "text_median_views", "single_image_median_views", "absolute_delta", "relative_delta_percent" ], "additionalProperties": false }, "suggestion": { "type": [ "object", "null" ], "properties": { "kind": { "type": "string", "enum": [ "single_image_variation" ] }, "owner_review_required": { "type": "boolean", "enum": [ true ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher" ] } }, "required": [ "kind", "owner_review_required", "reason" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher", "population_incomplete", "publication_identity_unavailable", "format_basis_unavailable", "observation_population_unqualified", "native_metric_basis_unavailable", "native_age_unavailable", "native_age_window_unqualified", "observations_stale", "minimum_cohort_unavailable", "no_supported_variation" ] }, "accepted": { "type": "boolean", "enum": [ true ] } }, "required": [ "evidence_id", "snapshot_sha256", "rule_version", "expires_at", "selection", "comparison", "suggestion", "reason", "accepted" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "entries", "holds", "provider_refresh", "model_transfer", "scheduled", "editorial_approval" ], "additionalProperties": false } }, "required": [ "plan" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationMediaDraftPlan", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:media-draft-plan:read and automation:media-draft-plan:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: preview, prepare, control, remove. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "preview" ] }, "id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false }, "result_adaptation": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "accepted": { "type": "boolean", "enum": [ true ] } }, "required": [ "evidence_id", "snapshot_sha256", "rule_version", "accepted" ], "additionalProperties": false } }, "required": [ "operation", "id", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "prepare" ] }, "id": { "type": "string", "format": "uuid" }, "consent": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "media-draft-preparation-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "entries": { "type": "array", "items": { "type": "object", "properties": { "entry_id": { "type": "string", "pattern": "^entry-\\d+$" }, "caption": { "type": "string", "minLength": 1, "maxLength": 300 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "entry_id", "caption", "alt_text" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 } }, "required": [ "operation", "id", "consent", "entries" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "control" ] }, "id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "pause", "resume", "revoke" ] } }, "required": [ "operation", "id", "action" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "remove" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "plan": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired", "completed" ] }, "created_at": { "type": "string" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "media-draft-preparation-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "entries": { "type": "array", "items": { "type": "object", "properties": { "entry_id": { "type": "string" }, "command_id": { "type": "string", "format": "uuid" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "asset": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "file_name": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 }, "width": { "type": "integer", "exclusiveMinimum": 0 }, "height": { "type": "integer", "exclusiveMinimum": 0 }, "expires_at": { "type": [ "string", "null" ] }, "last_used_at": { "type": [ "string", "null" ] }, "rights_state": { "type": "string", "enum": [ "unavailable" ] }, "recent_use_state": { "type": "string", "enum": [ "recorded", "unavailable" ] } }, "required": [ "id", "provider", "account_id", "file_name", "sha256", "mime_type", "file_size", "width", "height", "expires_at", "last_used_at", "rights_state", "recent_use_state" ], "additionalProperties": false }, "proposed_local_day": { "type": "string" }, "goal": { "type": "string" }, "reason": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "saved" ] }, "approval": { "type": [ "object", "null" ], "properties": { "entry_id": { "type": "string", "pattern": "^entry-\\d+$" }, "caption": { "type": "string", "minLength": 1, "maxLength": 300 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "entry_id", "caption", "alt_text" ], "additionalProperties": false }, "draft_id": { "type": [ "string", "null" ], "format": "uuid" }, "receipt": { "type": [ "object", "null" ], "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ], "additionalProperties": false } }, "required": [ "entry_id", "command_id", "target", "asset", "proposed_local_day", "goal", "reason", "state", "approval", "draft_id", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "holds": { "type": "array", "items": { "type": "object", "properties": { "asset_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "reason": { "type": "string" } }, "required": [ "asset_id", "reason" ], "additionalProperties": false }, "maxItems": 50 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "model_transfer": { "type": "boolean", "enum": [ false ] }, "scheduled": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "result_adaptation": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false }, "comparison": { "type": [ "object", "null" ], "properties": { "text_median_views": { "type": "number", "minimum": 0 }, "single_image_median_views": { "type": "number", "minimum": 0 }, "absolute_delta": { "type": "number" }, "relative_delta_percent": { "type": [ "number", "null" ] } }, "required": [ "text_median_views", "single_image_median_views", "absolute_delta", "relative_delta_percent" ], "additionalProperties": false }, "suggestion": { "type": [ "object", "null" ], "properties": { "kind": { "type": "string", "enum": [ "single_image_variation" ] }, "owner_review_required": { "type": "boolean", "enum": [ true ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher" ] } }, "required": [ "kind", "owner_review_required", "reason" ], "additionalProperties": false }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher", "population_incomplete", "publication_identity_unavailable", "format_basis_unavailable", "observation_population_unqualified", "native_metric_basis_unavailable", "native_age_unavailable", "native_age_window_unqualified", "observations_stale", "minimum_cohort_unavailable", "no_supported_variation" ] }, "accepted": { "type": "boolean", "enum": [ true ] } }, "required": [ "evidence_id", "snapshot_sha256", "rule_version", "expires_at", "selection", "comparison", "suggestion", "reason", "accepted" ], "additionalProperties": false } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "entries", "holds", "provider_refresh", "model_transfer", "scheduled", "editorial_approval" ], "additionalProperties": false } }, "required": [ "plan" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-result-suggestions": { "get": { "operationId": "readAutomationAnalyticsResultSuggestions", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-result-suggestions:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "suggestion": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.result-suggestion.v1" ] }, "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false }, "thresholds": { "type": "object", "properties": { "population_max": { "type": "number", "enum": [ 100 ] }, "minimum_per_format": { "type": "number", "enum": [ 5 ] }, "native_age_min_seconds": { "type": "number", "enum": [ 86400 ] }, "native_age_max_seconds": { "type": "number", "enum": [ 86700 ] }, "source_max_age_days": { "type": "number", "enum": [ 35 ] }, "suggestion_max_age_seconds": { "type": "number", "enum": [ 900 ] } }, "required": [ "population_max", "minimum_per_format", "native_age_min_seconds", "native_age_max_seconds", "source_max_age_days", "suggestion_max_age_seconds" ], "additionalProperties": false }, "status": { "type": "string", "enum": [ "qualified", "held" ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher", "population_incomplete", "publication_identity_unavailable", "format_basis_unavailable", "observation_population_unqualified", "native_metric_basis_unavailable", "native_age_unavailable", "native_age_window_unqualified", "observations_stale", "minimum_cohort_unavailable", "no_supported_variation" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "publication_period": { "type": "object", "properties": { "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "since", "until" ], "additionalProperties": false }, "counts": { "type": "object", "properties": { "population": { "type": "integer", "minimum": 0, "maximum": 101 }, "qualified_text": { "type": "integer", "minimum": 0, "maximum": 100 }, "qualified_single_image": { "type": "integer", "minimum": 0, "maximum": 100 } }, "required": [ "population", "qualified_text", "qualified_single_image" ], "additionalProperties": false }, "native_age_seconds": { "type": "object", "properties": { "min": { "type": [ "number", "null" ] }, "max": { "type": [ "number", "null" ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "local_capture_lag_seconds": { "type": "object", "properties": { "min": { "type": [ "number", "null" ] }, "max": { "type": [ "number", "null" ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "oldest_observation_at": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "observation_period": { "type": "object", "properties": { "since": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "since", "until" ], "additionalProperties": false }, "comparison": { "type": [ "object", "null" ], "properties": { "text_median_views": { "type": "number", "minimum": 0 }, "single_image_median_views": { "type": "number", "minimum": 0 }, "absolute_delta": { "type": "number" }, "relative_delta_percent": { "type": [ "number", "null" ] } }, "required": [ "text_median_views", "single_image_median_views", "absolute_delta", "relative_delta_percent" ], "additionalProperties": false }, "suggestions": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "single_image_variation" ] }, "owner_review_required": { "type": "boolean", "enum": [ true ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher" ] } }, "required": [ "kind", "owner_review_required", "reason" ], "additionalProperties": false }, "maxItems": 1 }, "effects": { "type": "string", "enum": [ "none" ] }, "causal": { "type": "boolean", "enum": [ false ] }, "equal_age_qualified": { "type": "boolean", "enum": [ false ] }, "model_quality_assessed": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "id", "workspace_id", "snapshot_sha256", "rule_version", "selection", "thresholds", "status", "reason", "captured_at", "expires_at", "publication_period", "counts", "native_age_seconds", "local_capture_lag_seconds", "oldest_observation_at", "observation_period", "comparison", "suggestions", "effects", "causal", "equal_age_qualified", "model_quality_assessed" ], "additionalProperties": false } }, "required": [ "suggestion" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsResultSuggestions", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-result-suggestions:read and automation:analytics-result-suggestions:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: capture, remove. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "capture" ] }, "id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "operation", "id", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "remove" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "suggestion": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.analytics.result-suggestion.v1" ] }, "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false }, "thresholds": { "type": "object", "properties": { "population_max": { "type": "number", "enum": [ 100 ] }, "minimum_per_format": { "type": "number", "enum": [ 5 ] }, "native_age_min_seconds": { "type": "number", "enum": [ 86400 ] }, "native_age_max_seconds": { "type": "number", "enum": [ 86700 ] }, "source_max_age_days": { "type": "number", "enum": [ 35 ] }, "suggestion_max_age_seconds": { "type": "number", "enum": [ 900 ] } }, "required": [ "population_max", "minimum_per_format", "native_age_min_seconds", "native_age_max_seconds", "source_max_age_days", "suggestion_max_age_seconds" ], "additionalProperties": false }, "status": { "type": "string", "enum": [ "qualified", "held" ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher", "population_incomplete", "publication_identity_unavailable", "format_basis_unavailable", "observation_population_unqualified", "native_metric_basis_unavailable", "native_age_unavailable", "native_age_window_unqualified", "observations_stale", "minimum_cohort_unavailable", "no_supported_variation" ] }, "captured_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "publication_period": { "type": "object", "properties": { "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "since", "until" ], "additionalProperties": false }, "counts": { "type": "object", "properties": { "population": { "type": "integer", "minimum": 0, "maximum": 101 }, "qualified_text": { "type": "integer", "minimum": 0, "maximum": 100 }, "qualified_single_image": { "type": "integer", "minimum": 0, "maximum": 100 } }, "required": [ "population", "qualified_text", "qualified_single_image" ], "additionalProperties": false }, "native_age_seconds": { "type": "object", "properties": { "min": { "type": [ "number", "null" ] }, "max": { "type": [ "number", "null" ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "local_capture_lag_seconds": { "type": "object", "properties": { "min": { "type": [ "number", "null" ] }, "max": { "type": [ "number", "null" ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "oldest_observation_at": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "observation_period": { "type": "object", "properties": { "since": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "since", "until" ], "additionalProperties": false }, "comparison": { "type": [ "object", "null" ], "properties": { "text_median_views": { "type": "number", "minimum": 0 }, "single_image_median_views": { "type": "number", "minimum": 0 }, "absolute_delta": { "type": "number" }, "relative_delta_percent": { "type": [ "number", "null" ] } }, "required": [ "text_median_views", "single_image_median_views", "absolute_delta", "relative_delta_percent" ], "additionalProperties": false }, "suggestions": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "single_image_variation" ] }, "owner_review_required": { "type": "boolean", "enum": [ true ] }, "reason": { "type": "string", "enum": [ "descriptive_image_median_higher" ] } }, "required": [ "kind", "owner_review_required", "reason" ], "additionalProperties": false }, "maxItems": 1 }, "effects": { "type": "string", "enum": [ "none" ] }, "causal": { "type": "boolean", "enum": [ false ] }, "equal_age_qualified": { "type": "boolean", "enum": [ false ] }, "model_quality_assessed": { "type": "boolean", "enum": [ false ] } }, "required": [ "schema", "id", "workspace_id", "snapshot_sha256", "rule_version", "selection", "thresholds", "status", "reason", "captured_at", "expires_at", "publication_period", "counts", "native_age_seconds", "local_capture_lag_seconds", "oldest_observation_at", "observation_period", "comparison", "suggestions", "effects", "causal", "equal_age_qualified", "model_quality_assessed" ], "additionalProperties": false } }, "required": [ "suggestion" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/reviewed-queue-fill": { "get": { "operationId": "readAutomationReviewedQueueFill", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:reviewed-queue-fill:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "batch": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired" ] }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "caption": { "type": "string" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "sha256": { "type": "string" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "id", "sha256", "mime_type", "file_size" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "held", "reserved", "scheduling", "scheduled", "uncertain", "missed" ] }, "reason": { "type": [ "string", "null" ] }, "receipt": { "type": [ "object", "null" ], "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "message_id": { "type": [ "string", "null" ] } }, "required": [ "post_id", "scheduled_for", "message_id" ], "additionalProperties": false } }, "required": [ "id", "command_id", "post_id", "target", "slot", "expected_fingerprint", "caption", "asset", "state", "reason", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "recurring": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "items", "provider_refresh", "editorial_approval", "recurring" ], "additionalProperties": false } }, "required": [ "batch" ], "additionalProperties": false }, { "type": "object", "properties": { "control": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "controlled": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked" ] } }, "required": [ "id", "controlled", "state" ], "additionalProperties": false }, "batch": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired" ] }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "caption": { "type": "string" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "sha256": { "type": "string" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "id", "sha256", "mime_type", "file_size" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "held", "reserved", "scheduling", "scheduled", "uncertain", "missed" ] }, "reason": { "type": [ "string", "null" ] }, "receipt": { "type": [ "object", "null" ], "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "message_id": { "type": [ "string", "null" ] } }, "required": [ "post_id", "scheduled_for", "message_id" ], "additionalProperties": false } }, "required": [ "id", "command_id", "post_id", "target", "slot", "expected_fingerprint", "caption", "asset", "state", "reason", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "recurring": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "items", "provider_refresh", "editorial_approval", "recurring" ], "additionalProperties": false }, "history_held": { "type": "boolean" } }, "required": [ "control", "batch", "history_held" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationReviewedQueueFill", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:reviewed-queue-fill:read and automation:reviewed-queue-fill:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: preview, admit, control, remove. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "preview" ] }, "id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false } }, "required": [ "operation", "id", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "admit" ] }, "id": { "type": "string", "format": "uuid" }, "consent": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false } }, "required": [ "operation", "id", "consent" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "control" ] }, "id": { "type": "string", "format": "uuid" }, "action": { "type": "string", "enum": [ "pause", "resume", "revoke" ] } }, "required": [ "operation", "id", "action" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "remove" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "batch": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired" ] }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "caption": { "type": "string" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "sha256": { "type": "string" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "id", "sha256", "mime_type", "file_size" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "held", "reserved", "scheduling", "scheduled", "uncertain", "missed" ] }, "reason": { "type": [ "string", "null" ] }, "receipt": { "type": [ "object", "null" ], "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "message_id": { "type": [ "string", "null" ] } }, "required": [ "post_id", "scheduled_for", "message_id" ], "additionalProperties": false } }, "required": [ "id", "command_id", "post_id", "target", "slot", "expected_fingerprint", "caption", "asset", "state", "reason", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "recurring": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "items", "provider_refresh", "editorial_approval", "recurring" ], "additionalProperties": false } }, "required": [ "batch" ], "additionalProperties": false }, { "type": "object", "properties": { "control": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "controlled": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked" ] } }, "required": [ "id", "controlled", "state" ], "additionalProperties": false }, "batch": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "active", "paused", "revoked", "expired" ] }, "created_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "consent": { "type": [ "object", "null" ], "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "caption": { "type": "string" }, "asset": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "sha256": { "type": "string" }, "mime_type": { "type": "string" }, "file_size": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "id", "sha256", "mime_type", "file_size" ], "additionalProperties": false }, "state": { "type": "string", "enum": [ "preview", "held", "reserved", "scheduling", "scheduled", "uncertain", "missed" ] }, "reason": { "type": [ "string", "null" ] }, "receipt": { "type": [ "object", "null" ], "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "scheduled_for": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "message_id": { "type": [ "string", "null" ] } }, "required": [ "post_id", "scheduled_for", "message_id" ], "additionalProperties": false } }, "required": [ "id", "command_id", "post_id", "target", "slot", "expected_fingerprint", "caption", "asset", "state", "reason", "receipt" ], "additionalProperties": false }, "maxItems": 14 }, "provider_refresh": { "type": "boolean", "enum": [ false ] }, "editorial_approval": { "type": "boolean", "enum": [ false ] }, "recurring": { "type": "boolean", "enum": [ false ] } }, "required": [ "id", "workspace_id", "selection", "state", "created_at", "consent", "items", "provider_refresh", "editorial_approval", "recurring" ], "additionalProperties": false }, "history_held": { "type": "boolean" } }, "required": [ "control", "batch", "history_held" ], "additionalProperties": false }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/social-workflow": { "get": { "operationId": "readAutomationSocialWorkflow", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:social-workflow:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "version_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "run_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "runs" ] }, "required": false, "name": "view", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "after", "in": "query" }, { "schema": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 20 }, { "type": "string", "pattern": "^(?:[1-9]|1[0-9]|20)$" } ] }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.social-workflow.v1" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "template": { "type": [ "string", "null" ], "enum": [ "report", "prepare_week", "reviewed_queue", "results_next_drafts", null ] }, "nodes": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "manual_trigger" ] }, "config": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "finite_trigger" ] }, "config": { "type": "object", "properties": { "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "first_local", "time_zone", "fold", "gap", "max_occurrences", "expires_at" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "facts_read" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "portfolio" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "results" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "approved_media_selection" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "from": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "from" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "prepare_drafts" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "media" ] }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "mode", "source", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "skill" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "mode", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "condition" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "predicate": { "type": "string", "enum": [ "available", "qualified", "has_entries", "completed", "saved" ] } }, "required": [ "source", "predicate" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "preview" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "review_wait" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "purpose": { "type": "string", "enum": [ "draft_save", "editorial", "queue_consent", "adaptation" ] }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "timeout_seconds" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "bounds": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" } }, "required": [ "targets", "goals", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata" ], "additionalProperties": false }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "bounds", "timeout_seconds" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "queue_command" ] }, "config": { "type": "object", "properties": { "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "confirmation" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "delay" ] }, "config": { "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "required": [ "seconds" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "outcome_read" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "end" ] }, "config": { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "maxItems": 16 } }, "required": [ "sources" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false } ] }, "minItems": 2, "maxItems": 32 }, "edges": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "target": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "branch": { "type": "string", "enum": [ "always", "true", "false" ], "default": "always" } }, "required": [ "source", "target" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "type": { "type": "string", "enum": [ "portfolio_report", "result_evidence", "media_plan", "draft_set", "reviewed_posts", "queue_batch", "skill_session", "boolean", "media_selection" ] } }, "required": [ "name", "source", "type" ], "additionalProperties": false }, "maxItems": 16 }, "limits": { "type": "object", "properties": { "max_items": { "type": "integer", "minimum": 0, "maximum": 14 }, "max_model_output_tokens": { "type": "integer", "minimum": 0, "maximum": 4000 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "max_items", "max_model_output_tokens", "expires_at" ], "additionalProperties": false } }, "required": [ "schema", "name", "template", "nodes", "edges", "variables", "limits" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" } }, "required": [ "id", "definition_id", "definition", "definition_sha256", "catalog_sha256", "qualified", "created_at" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string" }, "definition_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "operation", "version_id" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "version", "receipt", "recovered" ], "additionalProperties": false }, { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "original_intent": { "type": [ "object", "null" ], "additionalProperties": {} }, "output": {}, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "original_intent", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string" }, "definition_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "operation", "version_id" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "run" ], "additionalProperties": false }, { "type": "object", "properties": { "definitions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "active_version_id": { "type": [ "string", "null" ], "format": "uuid" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "id", "definition_id", "definition_sha256", "catalog_sha256", "qualified", "created_at", "active" ], "additionalProperties": false }, "maxItems": 64 } }, "required": [ "id", "revision", "active_version_id", "versions" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "definitions" ], "additionalProperties": false }, { "type": "object", "properties": { "version": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.social-workflow.v1" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "template": { "type": [ "string", "null" ], "enum": [ "report", "prepare_week", "reviewed_queue", "results_next_drafts", null ] }, "nodes": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "manual_trigger" ] }, "config": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "finite_trigger" ] }, "config": { "type": "object", "properties": { "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "first_local", "time_zone", "fold", "gap", "max_occurrences", "expires_at" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "facts_read" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "portfolio" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "results" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "approved_media_selection" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "from": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "from" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "prepare_drafts" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "media" ] }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "mode", "source", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "skill" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "mode", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "condition" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "predicate": { "type": "string", "enum": [ "available", "qualified", "has_entries", "completed", "saved" ] } }, "required": [ "source", "predicate" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "preview" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "review_wait" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "purpose": { "type": "string", "enum": [ "draft_save", "editorial", "queue_consent", "adaptation" ] }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "timeout_seconds" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "bounds": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" } }, "required": [ "targets", "goals", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata" ], "additionalProperties": false }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "bounds", "timeout_seconds" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "queue_command" ] }, "config": { "type": "object", "properties": { "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "confirmation" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "delay" ] }, "config": { "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "required": [ "seconds" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "outcome_read" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "end" ] }, "config": { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "maxItems": 16 } }, "required": [ "sources" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false } ] }, "minItems": 2, "maxItems": 32 }, "edges": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "target": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "branch": { "type": "string", "enum": [ "always", "true", "false" ], "default": "always" } }, "required": [ "source", "target" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "type": { "type": "string", "enum": [ "portfolio_report", "result_evidence", "media_plan", "draft_set", "reviewed_posts", "queue_batch", "skill_session", "boolean", "media_selection" ] } }, "required": [ "name", "source", "type" ], "additionalProperties": false }, "maxItems": 16 }, "limits": { "type": "object", "properties": { "max_items": { "type": "integer", "minimum": 0, "maximum": 14 }, "max_model_output_tokens": { "type": "integer", "minimum": 0, "maximum": 4000 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "max_items", "max_model_output_tokens", "expires_at" ], "additionalProperties": false } }, "required": [ "schema", "name", "template", "nodes", "edges", "variables", "limits" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" } }, "required": [ "id", "definition_id", "definition", "definition_sha256", "catalog_sha256", "qualified", "created_at" ], "additionalProperties": false }, "revision": { "type": "string", "format": "uuid" }, "active_version_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "version", "revision", "active_version_id" ], "additionalProperties": false }, { "type": "object", "properties": { "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": [ "string", "null" ], "format": "uuid" }, "rows": { "type": "array", "items": { "type": "object", "properties": { "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "occurrence": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "planned", "admitted", "missed", "skipped" ] } }, "required": [ "id", "local_due", "due_at", "state" ], "additionalProperties": false }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false } }, "required": [ "run_id", "version_id", "ordinal", "occurrence", "run" ], "additionalProperties": false }, "maxItems": 20 }, "next_after": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "definition_id", "version_id", "rows", "next_after" ], "additionalProperties": false }, { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "original_intent": { "type": [ "object", "null" ], "additionalProperties": {} }, "output": {}, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "original_intent", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false } }, "required": [ "run" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationSocialWorkflow", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:social-workflow:read and automation:social-workflow:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: save_version, qualify, activate, start, continue, supply_wait, pause, resume, cancel, revoke. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "save_version" ] }, "id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": [ "string", "null" ], "format": "uuid" }, "definition": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.social-workflow.v1" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "template": { "type": [ "string", "null" ], "enum": [ "report", "prepare_week", "reviewed_queue", "results_next_drafts", null ] }, "nodes": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "manual_trigger" ] }, "config": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "finite_trigger" ] }, "config": { "type": "object", "properties": { "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "first_local", "time_zone", "fold", "gap", "max_occurrences", "expires_at" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "facts_read" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "portfolio" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "results" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "approved_media_selection" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "from": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "from" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "prepare_drafts" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "media" ] }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "mode", "source", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "skill" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "mode", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "condition" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "predicate": { "type": "string", "enum": [ "available", "qualified", "has_entries", "completed", "saved" ] } }, "required": [ "source", "predicate" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "preview" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "review_wait" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "purpose": { "type": "string", "enum": [ "draft_save", "editorial", "queue_consent", "adaptation" ] }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "timeout_seconds" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "bounds": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" } }, "required": [ "targets", "goals", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata" ], "additionalProperties": false }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "bounds", "timeout_seconds" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "queue_command" ] }, "config": { "type": "object", "properties": { "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "confirmation" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "delay" ] }, "config": { "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "required": [ "seconds" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "outcome_read" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "end" ] }, "config": { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "maxItems": 16 } }, "required": [ "sources" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false } ] }, "minItems": 2, "maxItems": 32 }, "edges": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "target": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "branch": { "type": "string", "enum": [ "always", "true", "false" ], "default": "always" } }, "required": [ "source", "target" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "type": { "type": "string", "enum": [ "portfolio_report", "result_evidence", "media_plan", "draft_set", "reviewed_posts", "queue_batch", "skill_session", "boolean", "media_selection" ] } }, "required": [ "name", "source", "type" ], "additionalProperties": false }, "maxItems": 16 }, "limits": { "type": "object", "properties": { "max_items": { "type": "integer", "minimum": 0, "maximum": 14 }, "max_model_output_tokens": { "type": "integer", "minimum": 0, "maximum": 4000 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "max_items", "max_model_output_tokens", "expires_at" ], "additionalProperties": false } }, "required": [ "schema", "name", "template", "nodes", "edges", "variables", "limits" ], "additionalProperties": false } }, "required": [ "operation", "id", "version_id", "command_id", "expected_revision", "definition" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "qualify" ] }, "id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id", "version_id", "command_id" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "activate" ] }, "id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "social-workflow-20261002-v1" ] } }, "required": [ "operation", "id", "version_id", "command_id", "expected_revision", "definition_sha256", "authorized", "consent_version" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "start" ] }, "id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "operation", "id", "version_id", "command_id", "run_id", "definition_sha256" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "continue" ] }, "run_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "run_id" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "supply_wait" ] }, "run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" }, "step_id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "input": { "oneOf": [ { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "purpose", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "draft_save" ] }, "consent": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "media-draft-preparation-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false }, "entries": { "type": "array", "items": { "type": "object", "properties": { "entry_id": { "type": "string", "pattern": "^entry-\\d+$" }, "caption": { "type": "string", "minLength": 1, "maxLength": 300 }, "alt_text": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "entry_id", "caption", "alt_text" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 } }, "required": [ "purpose", "consent", "entries" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "editorial" ] }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "consent": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false } }, "required": [ "purpose", "selection", "consent" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "queue_consent" ] }, "selection": { "type": "object", "properties": { "queue_id": { "type": "string", "format": "uuid" }, "expected_queue_revision": { "type": "integer", "minimum": 1 }, "items": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "expected_fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "slot": { "type": "object", "properties": { "local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "offset_minutes": { "type": "integer", "minimum": -840, "maximum": 840 }, "fold": { "type": "string", "enum": [ "unambiguous", "earlier", "later" ] }, "instant": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "local", "time_zone", "offset_minutes", "fold", "instant" ], "additionalProperties": false } }, "required": [ "post_id", "expected_fingerprint", "slot" ], "additionalProperties": false }, "minItems": 1, "maxItems": 14 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "queue_id", "expected_queue_revision", "items", "expires_at" ], "additionalProperties": false }, "consent": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "reviewed-queue-fill-20261002-v1" ] }, "authorized": { "type": "boolean", "enum": [ true ] } }, "required": [ "version", "authorized" ], "additionalProperties": false } }, "required": [ "purpose", "selection", "consent" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "adaptation" ] }, "evidence_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rule_version": { "type": "string", "enum": [ "threads-native-views-format-24h-v1" ] }, "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false }, "accepted": { "type": "boolean", "enum": [ true ] } }, "required": [ "purpose", "evidence_id", "snapshot_sha256", "rule_version", "selection", "accepted" ], "additionalProperties": false } ] } }, "required": [ "operation", "run_id", "command_id", "expected_revision", "step_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "pause", "resume", "cancel", "revoke" ] }, "run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "string", "format": "uuid" } }, "required": [ "operation", "run_id", "command_id", "expected_revision" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "version": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.social-workflow.v1" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "template": { "type": [ "string", "null" ], "enum": [ "report", "prepare_week", "reviewed_queue", "results_next_drafts", null ] }, "nodes": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "manual_trigger" ] }, "config": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "finite_trigger" ] }, "config": { "type": "object", "properties": { "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "first_local", "time_zone", "fold", "gap", "max_occurrences", "expires_at" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "facts_read" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "portfolio" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "results" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "approved_media_selection" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "from": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "from" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "prepare_drafts" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "media" ] }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "mode", "source", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "skill" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "mode", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "condition" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "predicate": { "type": "string", "enum": [ "available", "qualified", "has_entries", "completed", "saved" ] } }, "required": [ "source", "predicate" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "preview" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "review_wait" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "purpose": { "type": "string", "enum": [ "draft_save", "editorial", "queue_consent", "adaptation" ] }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "timeout_seconds" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "bounds": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" } }, "required": [ "targets", "goals", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata" ], "additionalProperties": false }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "bounds", "timeout_seconds" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "queue_command" ] }, "config": { "type": "object", "properties": { "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "confirmation" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "delay" ] }, "config": { "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "required": [ "seconds" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "outcome_read" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "end" ] }, "config": { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "maxItems": 16 } }, "required": [ "sources" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false } ] }, "minItems": 2, "maxItems": 32 }, "edges": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "target": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "branch": { "type": "string", "enum": [ "always", "true", "false" ], "default": "always" } }, "required": [ "source", "target" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "type": { "type": "string", "enum": [ "portfolio_report", "result_evidence", "media_plan", "draft_set", "reviewed_posts", "queue_batch", "skill_session", "boolean", "media_selection" ] } }, "required": [ "name", "source", "type" ], "additionalProperties": false }, "maxItems": 16 }, "limits": { "type": "object", "properties": { "max_items": { "type": "integer", "minimum": 0, "maximum": 14 }, "max_model_output_tokens": { "type": "integer", "minimum": 0, "maximum": 4000 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "max_items", "max_model_output_tokens", "expires_at" ], "additionalProperties": false } }, "required": [ "schema", "name", "template", "nodes", "edges", "variables", "limits" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" } }, "required": [ "id", "definition_id", "definition", "definition_sha256", "catalog_sha256", "qualified", "created_at" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string" }, "definition_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "operation", "version_id" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "version", "receipt", "recovered" ], "additionalProperties": false }, { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "original_intent": { "type": [ "object", "null" ], "additionalProperties": {} }, "output": {}, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "original_intent", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string" }, "definition_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "revision": { "type": "string", "format": "uuid" } }, "required": [ "command_id", "operation", "version_id" ], "additionalProperties": false }, "recovered": { "type": "boolean" } }, "required": [ "run" ], "additionalProperties": false }, { "type": "object", "properties": { "definitions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "revision": { "type": "string", "format": "uuid" }, "active_version_id": { "type": [ "string", "null" ], "format": "uuid" }, "versions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "id", "definition_id", "definition_sha256", "catalog_sha256", "qualified", "created_at", "active" ], "additionalProperties": false }, "maxItems": 64 } }, "required": [ "id", "revision", "active_version_id", "versions" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "definitions" ], "additionalProperties": false }, { "type": "object", "properties": { "version": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.social-workflow.v1" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "template": { "type": [ "string", "null" ], "enum": [ "report", "prepare_week", "reviewed_queue", "results_next_drafts", null ] }, "nodes": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "manual_trigger" ] }, "config": { "type": "object", "properties": {}, "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "finite_trigger" ] }, "config": { "type": "object", "properties": { "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 4 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "first_local", "time_zone", "fold", "gap", "max_occurrences", "expires_at" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "facts_read" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "portfolio" ] }, "selection": { "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "facebook", "tiktok", "x", "snapchat", "reddit", "youtube", "bluesky", "linkedin", "pinterest", "google_business", "discord" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 12 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "metric_keys": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z][a-z0-9_]*$" }, "minItems": 1, "maxItems": 8 } }, "required": [ "accounts", "since", "until", "time_zone", "metric_keys" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "reader": { "type": "string", "enum": [ "results" ] }, "selection": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "metric": { "type": "string", "enum": [ "views" ] }, "capture_window": { "type": "string", "enum": [ "24h" ] }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "account_id", "metric", "capture_window", "since", "until", "time_zone" ], "additionalProperties": false } }, "required": [ "reader", "selection" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "approved_media_selection" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "selection": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "asset_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 50 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "start_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "targets", "asset_ids", "goals", "start_local", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata", "expires_at" ], "additionalProperties": false } }, "required": [ "selection" ], "additionalProperties": false }, { "type": "object", "properties": { "from": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "from" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "prepare_drafts" ] }, "config": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "media" ] }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "mode", "source", "confirmation" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "skill" ] }, "policy_id": { "type": "string", "format": "uuid" } }, "required": [ "mode", "policy_id" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "condition" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "predicate": { "type": "string", "enum": [ "available", "qualified", "has_entries", "completed", "saved" ] } }, "required": [ "source", "predicate" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "preview" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "review_wait" ] }, "config": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "purpose": { "type": "string", "enum": [ "draft_save", "editorial", "queue_consent", "adaptation" ] }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "timeout_seconds" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "enum": [ "media_selection" ] }, "bounds": { "type": "object", "properties": { "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads", "instagram", "bluesky", "facebook" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "minItems": 1, "maxItems": 6 }, "goals": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 }, "minItems": 1, "maxItems": 8 }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "horizon_days": { "type": "integer", "minimum": 1, "maximum": 7 }, "max_drafts": { "type": "integer", "minimum": 1, "maximum": 14 }, "repetition": { "type": "object", "properties": { "within_plan": { "type": "string", "enum": [ "once" ] }, "avoid_recent_days": { "type": "integer", "minimum": 0, "maximum": 90 }, "require_recorded_use": { "type": "boolean" } }, "required": [ "within_plan", "avoid_recent_days", "require_recorded_use" ], "additionalProperties": false }, "require_rights_metadata": { "type": "boolean" } }, "required": [ "targets", "goals", "time_zone", "horizon_days", "max_drafts", "repetition", "require_rights_metadata" ], "additionalProperties": false }, "timeout_seconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "required": [ "purpose", "bounds", "timeout_seconds" ], "additionalProperties": false } ] } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "queue_command" ] }, "config": { "type": "object", "properties": { "confirmation": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "confirmation" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "delay" ] }, "config": { "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 1, "maximum": 86400 } }, "required": [ "seconds" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "outcome_read" ] }, "config": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" } }, "required": [ "source" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "join": { "type": "string", "enum": [ "all", "any" ], "default": "all" }, "kind": { "type": "string", "enum": [ "end" ] }, "config": { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "maxItems": 16 } }, "required": [ "sources" ], "additionalProperties": false } }, "required": [ "id", "kind", "config" ], "additionalProperties": false } ] }, "minItems": 2, "maxItems": 32 }, "edges": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "target": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "branch": { "type": "string", "enum": [ "always", "true", "false" ], "default": "always" } }, "required": [ "source", "target" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "source": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "type": { "type": "string", "enum": [ "portfolio_report", "result_evidence", "media_plan", "draft_set", "reviewed_posts", "queue_batch", "skill_session", "boolean", "media_selection" ] } }, "required": [ "name", "source", "type" ], "additionalProperties": false }, "maxItems": 16 }, "limits": { "type": "object", "properties": { "max_items": { "type": "integer", "minimum": 0, "maximum": 14 }, "max_model_output_tokens": { "type": "integer", "minimum": 0, "maximum": 4000 }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "max_items", "max_model_output_tokens", "expires_at" ], "additionalProperties": false } }, "required": [ "schema", "name", "template", "nodes", "edges", "variables", "limits" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "qualified": { "type": "boolean" }, "created_at": { "type": "string" } }, "required": [ "id", "definition_id", "definition", "definition_sha256", "catalog_sha256", "qualified", "created_at" ], "additionalProperties": false }, "revision": { "type": "string", "format": "uuid" }, "active_version_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "version", "revision", "active_version_id" ], "additionalProperties": false }, { "type": "object", "properties": { "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": [ "string", "null" ], "format": "uuid" }, "rows": { "type": "array", "items": { "type": "object", "properties": { "run_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "occurrence": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ], "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "state": { "type": "string", "enum": [ "planned", "admitted", "missed", "skipped" ] } }, "required": [ "id", "local_due", "due_at", "state" ], "additionalProperties": false }, "run": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false } }, "required": [ "run_id", "version_id", "ordinal", "occurrence", "run" ], "additionalProperties": false }, "maxItems": 20 }, "next_after": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "definition_id", "version_id", "rows", "next_after" ], "additionalProperties": false }, { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalog_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "actor_user_id": { "type": "string" }, "workspace_id": { "type": "string" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 4 }, "state": { "type": "string", "enum": [ "ready", "running", "waiting", "completed", "partial", "held", "cancelled", "expired" ] }, "paused": { "type": "boolean" }, "revoked_at": { "type": [ "string", "null" ] }, "cancelled_at": { "type": [ "string", "null" ] }, "revision": { "type": "string", "format": "uuid" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,47}$" }, "kind": { "type": "string" }, "state": { "type": "string", "enum": [ "pending", "claimed", "waiting_owner", "waiting_time", "completed", "skipped", "held_unknown", "held_authority", "cancelled", "expired" ] }, "domain_id": { "type": "string", "format": "uuid" }, "original_intent": { "type": [ "object", "null" ], "additionalProperties": {} }, "output": {}, "reason": { "type": [ "string", "null" ] }, "wake_at": { "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "usage": { "type": "object", "properties": { "allowance_output_tokens": { "type": "integer", "minimum": 0 }, "actual_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "allowance_output_tokens", "actual_output_tokens" ], "additionalProperties": false } }, "required": [ "id", "kind", "state", "domain_id", "original_intent", "reason", "wake_at", "deadline", "usage" ], "additionalProperties": false }, "maxItems": 32 } }, "required": [ "id", "definition_id", "version_id", "version_sha256", "catalog_sha256", "actor_user_id", "workspace_id", "ordinal", "state", "paused", "revoked_at", "cancelled_at", "revision", "created_at", "expires_at", "steps" ], "additionalProperties": false } }, "required": [ "run" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-ask": { "get": { "operationId": "readAutomationAnalyticsAsk", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-ask:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "run_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "reading", "ready", "sending", "completed", "failed", "cancelled", "uncertain" ] }, "question": { "type": "string" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "transfer_state": { "type": "string", "enum": [ "not_started", "started", "responded", "unknown" ] }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ] }, "max_output_tokens": { "type": "number", "enum": [ 500 ] }, "error_code": { "type": [ "string", "null" ] }, "result": { "type": [ "object", "null" ], "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "metric_key": { "type": [ "string", "null" ] }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] } }, "selection": { "type": "object", "properties": { "platform": { "type": "string" }, "view": { "type": "string" }, "since": { "type": "string" }, "until": { "type": "string" }, "time_zone": { "type": "string" }, "snapshot_through": { "type": [ "string", "null" ] }, "eligible_entities": { "type": [ "number", "null" ] } }, "required": [ "platform", "view", "since", "until", "time_zone", "snapshot_through", "eligible_entities" ] } }, "required": [ "supported", "reason", "metric_key", "answer", "facts", "selection" ], "additionalProperties": false } }, "required": [ "id", "state", "question", "selection", "created_at", "updated_at", "cancel_requested", "transfer_state", "usage", "max_output_tokens", "error_code", "result" ] } }, "required": [ "run" ], "additionalProperties": false } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsAsk", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-ask:read and automation:analytics-ask:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: ask, cancel. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] }, "run_id": { "type": "string", "format": "uuid" }, "question": { "type": "string", "minLength": 2, "maxLength": 500 }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] } }, "required": [ "platform", "scope", "since", "current_since", "until", "time_zone", "view", "run_id", "question", "transfer_authorized", "consent_version" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "cancel" ] }, "run_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "run_id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "reading", "ready", "sending", "completed", "failed", "cancelled", "uncertain" ] }, "question": { "type": "string" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "transfer_state": { "type": "string", "enum": [ "not_started", "started", "responded", "unknown" ] }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ] }, "max_output_tokens": { "type": "number", "enum": [ 500 ] }, "error_code": { "type": [ "string", "null" ] }, "result": { "type": [ "object", "null" ], "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "metric_key": { "type": [ "string", "null" ] }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] } }, "selection": { "type": "object", "properties": { "platform": { "type": "string" }, "view": { "type": "string" }, "since": { "type": "string" }, "until": { "type": "string" }, "time_zone": { "type": "string" }, "snapshot_through": { "type": [ "string", "null" ] }, "eligible_entities": { "type": [ "number", "null" ] } }, "required": [ "platform", "view", "since", "until", "time_zone", "snapshot_through", "eligible_entities" ] } }, "required": [ "supported", "reason", "metric_key", "answer", "facts", "selection" ], "additionalProperties": false } }, "required": [ "id", "state", "question", "selection", "created_at", "updated_at", "cancel_requested", "transfer_state", "usage", "max_output_tokens", "error_code", "result" ] } }, "required": [ "run" ], "additionalProperties": false } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-tool-run": { "get": { "operationId": "readAutomationAnalyticsToolRun", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-tool-run:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "run_id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "source_run_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "brand-preview" ] }, "required": false, "name": "view", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "grounding": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-grounding.v1" ] }, "run_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "captured_at": { "type": "string" }, "citations": { "type": "array", "items": { "type": "object", "properties": { "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "source_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "version_created_at": { "type": "string" }, "current_version_id": { "type": "string", "format": "uuid" }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "removed_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] }, "verified_at": { "type": "string" } }, "required": [ "citation_id", "source_id", "version_id", "version", "kind", "title", "text", "content_sha256", "version_created_at", "current_version_id", "current_version", "removed_at", "state", "verified_at" ], "additionalProperties": false }, "maxItems": 8 }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "brand_consent": { "type": [ "object", "null" ], "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "schema", "run_id", "mode", "source_run_id", "workspace_id", "snapshot_sha256", "captured_at", "citations", "total_available", "omitted", "reason", "brand_consent" ], "additionalProperties": false }, "skill": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "state": { "type": "string", "enum": [ "current", "superseded", "retired" ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "title", "state", "consent_version", "transfer_authorized", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "run" ], "additionalProperties": false }, { "type": "object", "properties": { "preview": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-grounding.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "retrieval": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-knowledge.retrieval.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "read_at": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "maxItems": 8 }, "selection": { "type": "string", "enum": [ "active_sources_by_id" ] }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "complete": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "schema", "workspace_id", "read_at", "sources", "selection", "total_available", "omitted", "complete", "reason", "model_transfer" ] } }, "required": [ "schema", "workspace_id", "snapshot_sha256", "retrieval" ], "additionalProperties": false } }, "required": [ "preview" ], "additionalProperties": false }, { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsToolRun", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-tool-run:read and automation:analytics-tool-run:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: start, resume, cancel, confirm_draft. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "run_id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "question": { "type": "string", "minLength": 2, "maxLength": 500 }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-aggregate-20261001-v1" ] }, "loop_authorized": { "type": "boolean", "enum": [ true ] }, "loop_consent_version": { "type": "string", "enum": [ "analytics-tools-20261001-v1" ] }, "brand_consent": { "type": "object", "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "skill_selection": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "transfer_authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] } }, "required": [ "run_id", "source_run_id", "question", "transfer_authorized", "consent_version", "loop_authorized", "loop_consent_version", "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "run_id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "resume", "cancel" ] } }, "required": [ "run_id", "operation" ], "additionalProperties": false }, { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "loop_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "caption": { "type": "string", "maxLength": 2000 }, "target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "confirm": { "type": "boolean", "enum": [ true ] }, "operation": { "type": "string", "enum": [ "confirm_draft" ] } }, "required": [ "source_run_id", "command_id", "caption", "target", "confirm", "operation" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false }, "grounding": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-grounding.v1" ] }, "run_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "captured_at": { "type": "string" }, "citations": { "type": "array", "items": { "type": "object", "properties": { "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "source_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "version_created_at": { "type": "string" }, "current_version_id": { "type": "string", "format": "uuid" }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "removed_at": { "type": [ "string", "null" ] }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] }, "verified_at": { "type": "string" } }, "required": [ "citation_id", "source_id", "version_id", "version", "kind", "title", "text", "content_sha256", "version_created_at", "current_version_id", "current_version", "removed_at", "state", "verified_at" ], "additionalProperties": false }, "maxItems": 8 }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "brand_consent": { "type": [ "object", "null" ], "properties": { "authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "brand-text-20261001-v1" ] }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "authorized", "consent_version", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "schema", "run_id", "mode", "source_run_id", "workspace_id", "snapshot_sha256", "captured_at", "citations", "total_available", "omitted", "reason", "brand_consent" ], "additionalProperties": false }, "skill": { "type": "object", "properties": { "skill_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "trigger": { "type": "string", "enum": [ "analytics.explain_findings", "analytics.prepare_text_idea" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "state": { "type": "string", "enum": [ "current", "superseded", "retired" ] }, "consent_version": { "type": "string", "enum": [ "analytics-skill-text-20261002-v1" ] }, "transfer_authorized": { "type": "boolean", "enum": [ true ] }, "snapshot_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "skill_id", "version_id", "trigger", "title", "state", "consent_version", "transfer_authorized", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "run" ], "additionalProperties": false }, { "type": "object", "properties": { "preview": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-grounding.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "retrieval": { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-knowledge.retrieval.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "read_at": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "maxItems": 8 }, "selection": { "type": "string", "enum": [ "active_sources_by_id" ] }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "complete": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "schema", "workspace_id", "read_at", "sources", "selection", "total_available", "omitted", "complete", "reason", "model_transfer" ] } }, "required": [ "schema", "workspace_id", "snapshot_sha256", "retrieval" ], "additionalProperties": false } }, "required": [ "preview" ], "additionalProperties": false }, { "type": "object", "properties": { "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/analytics-recurring": { "get": { "operationId": "readAutomationAnalyticsRecurring", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:analytics-recurring:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string" }, "source_run_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "version": { "type": "number", "enum": [ 1 ] }, "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string" }, "native_id": { "type": "string" }, "view": { "type": "string", "enum": [ "accounts", "content" ] }, "ask_question": { "type": "string" }, "objective": { "type": "string" }, "first_local": { "type": "string" }, "time_zone": { "type": "string" }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "cadence": { "type": "string", "enum": [ "weekly" ] }, "expires_at": { "type": "string" }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 52 }, "consent_version": { "type": "string", "enum": [ "analytics-recurring-20261002-v1" ] }, "future_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "allowance": { "type": "object", "properties": { "ask_output_tokens": { "type": "number", "enum": [ 500 ] }, "continuation_output_tokens": { "type": "number", "enum": [ 500 ] }, "model_steps": { "type": "number", "enum": [ 4 ] }, "tool_steps": { "type": "number", "enum": [ 4 ] }, "input_bytes": { "type": "number", "enum": [ 12000 ] }, "stage_deadline_ms": { "type": "number", "enum": [ 18000 ] }, "concurrency": { "type": "number", "enum": [ 1 ] } }, "required": [ "ask_output_tokens", "continuation_output_tokens", "model_steps", "tool_steps", "input_bytes", "stage_deadline_ms", "concurrency" ], "additionalProperties": false }, "toolkit_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version", "provider", "account_id", "native_id", "view", "ask_question", "objective", "first_local", "time_zone", "fold", "gap", "cadence", "expires_at", "max_occurrences", "consent_version", "future_transfer_authorized", "allowance", "toolkit_sha256" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "execution_hold": { "type": [ "string", "null" ], "enum": [ "EXECUTION_DEFINITION_CHANGED" ] }, "revoked_at": { "type": [ "string", "null" ] }, "next_ordinal": { "type": "integer", "minimum": 1, "maximum": 53 }, "reserved_output_tokens": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "occurrences_loaded": { "type": "boolean" }, "occurrence_count": { "type": "integer", "minimum": 0, "maximum": 52 }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "ask_run_id": { "type": "string", "format": "uuid" }, "tool_run_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "error_code": { "type": [ "string", "null" ] }, "reserved_output_tokens": { "type": "integer", "minimum": 0, "maximum": 1000 }, "observed_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "ask": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "reading", "ready", "sending", "completed", "failed", "cancelled", "uncertain" ] }, "question": { "type": "string" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "transfer_state": { "type": "string", "enum": [ "not_started", "started", "responded", "unknown" ] }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ] }, "max_output_tokens": { "type": "number", "enum": [ 500 ] }, "error_code": { "type": [ "string", "null" ] }, "result": { "type": [ "object", "null" ], "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "metric_key": { "type": [ "string", "null" ] }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] } }, "selection": { "type": "object", "properties": { "platform": { "type": "string" }, "view": { "type": "string" }, "since": { "type": "string" }, "until": { "type": "string" }, "time_zone": { "type": "string" }, "snapshot_through": { "type": [ "string", "null" ] }, "eligible_entities": { "type": [ "number", "null" ] } }, "required": [ "platform", "view", "since", "until", "time_zone", "snapshot_through", "eligible_entities" ] } }, "required": [ "supported", "reason", "metric_key", "answer", "facts", "selection" ], "additionalProperties": false } }, "required": [ "id", "state", "question", "selection", "created_at", "updated_at", "cancel_requested", "transfer_state", "usage", "max_output_tokens", "error_code", "result" ] }, "tool": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false } }, "required": [ "id", "ordinal", "local_due", "due_at", "ask_run_id", "tool_run_id", "state", "error_code", "reserved_output_tokens", "observed_output_tokens", "ask", "tool" ], "additionalProperties": false }, "maxItems": 52 } }, "required": [ "id", "version", "workspace_id", "source_run_id", "definition", "definition_sha256", "paused", "revoked_at", "next_ordinal", "reserved_output_tokens", "created_at", "occurrences_loaded", "occurrence_count", "occurrences" ], "additionalProperties": false }, "maxItems": 100 }, "execution": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "operator_disabled", "model_not_configured", null ] } }, "required": [ "enabled", "reason" ], "additionalProperties": false } }, "required": [ "policies", "execution" ], "additionalProperties": false } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationAnalyticsRecurring", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:analytics-recurring:read and automation:analytics-recurring:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: create, pause, resume, revoke, cancel. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "anyOf": [ { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "create" ] }, "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "first_local": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "expires_at": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 52 }, "objective": { "type": "string", "minLength": 2, "maxLength": 500 }, "future_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "consent_version": { "type": "string", "enum": [ "analytics-recurring-20261002-v1" ] } }, "required": [ "operation", "id", "source_run_id", "first_local", "time_zone", "fold", "gap", "expires_at", "max_occurrences", "objective", "future_transfer_authorized", "consent_version" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "pause", "resume", "revoke", "cancel" ] }, "id": { "type": "string", "format": "uuid" }, "occurrence_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "type": "object", "properties": { "policies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "version": { "type": "number", "enum": [ 1 ] }, "workspace_id": { "type": "string" }, "source_run_id": { "type": "string", "format": "uuid" }, "definition": { "type": "object", "properties": { "version": { "type": "number", "enum": [ 1 ] }, "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string" }, "native_id": { "type": "string" }, "view": { "type": "string", "enum": [ "accounts", "content" ] }, "ask_question": { "type": "string" }, "objective": { "type": "string" }, "first_local": { "type": "string" }, "time_zone": { "type": "string" }, "fold": { "type": "string", "enum": [ "earlier", "later" ] }, "gap": { "type": "string", "enum": [ "skip" ] }, "cadence": { "type": "string", "enum": [ "weekly" ] }, "expires_at": { "type": "string" }, "max_occurrences": { "type": "integer", "minimum": 1, "maximum": 52 }, "consent_version": { "type": "string", "enum": [ "analytics-recurring-20261002-v1" ] }, "future_transfer_authorized": { "type": "boolean", "enum": [ true ] }, "allowance": { "type": "object", "properties": { "ask_output_tokens": { "type": "number", "enum": [ 500 ] }, "continuation_output_tokens": { "type": "number", "enum": [ 500 ] }, "model_steps": { "type": "number", "enum": [ 4 ] }, "tool_steps": { "type": "number", "enum": [ 4 ] }, "input_bytes": { "type": "number", "enum": [ 12000 ] }, "stage_deadline_ms": { "type": "number", "enum": [ 18000 ] }, "concurrency": { "type": "number", "enum": [ 1 ] } }, "required": [ "ask_output_tokens", "continuation_output_tokens", "model_steps", "tool_steps", "input_bytes", "stage_deadline_ms", "concurrency" ], "additionalProperties": false }, "toolkit_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "version", "provider", "account_id", "native_id", "view", "ask_question", "objective", "first_local", "time_zone", "fold", "gap", "cadence", "expires_at", "max_occurrences", "consent_version", "future_transfer_authorized", "allowance", "toolkit_sha256" ], "additionalProperties": false }, "definition_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "paused": { "type": "boolean" }, "execution_hold": { "type": [ "string", "null" ], "enum": [ "EXECUTION_DEFINITION_CHANGED" ] }, "revoked_at": { "type": [ "string", "null" ] }, "next_ordinal": { "type": "integer", "minimum": 1, "maximum": 53 }, "reserved_output_tokens": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" }, "occurrences_loaded": { "type": "boolean" }, "occurrence_count": { "type": "integer", "minimum": 0, "maximum": 52 }, "occurrences": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "ordinal": { "type": "integer", "minimum": 1, "maximum": 52 }, "local_due": { "type": "string" }, "due_at": { "type": [ "string", "null" ] }, "ask_run_id": { "type": "string", "format": "uuid" }, "tool_run_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "queued", "running", "awaiting_owner", "completed", "failed", "cancelled", "uncertain", "skipped" ] }, "error_code": { "type": [ "string", "null" ] }, "reserved_output_tokens": { "type": "integer", "minimum": 0, "maximum": 1000 }, "observed_output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "ask": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "reading", "ready", "sending", "completed", "failed", "cancelled", "uncertain" ] }, "question": { "type": "string" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "transfer_state": { "type": "string", "enum": [ "not_started", "started", "responded", "unknown" ] }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ] }, "max_output_tokens": { "type": "number", "enum": [ 500 ] }, "error_code": { "type": [ "string", "null" ] }, "result": { "type": [ "object", "null" ], "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "metric_key": { "type": [ "string", "null" ] }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] } }, "selection": { "type": "object", "properties": { "platform": { "type": "string" }, "view": { "type": "string" }, "since": { "type": "string" }, "until": { "type": "string" }, "time_zone": { "type": "string" }, "snapshot_through": { "type": [ "string", "null" ] }, "eligible_entities": { "type": [ "number", "null" ] } }, "required": [ "platform", "view", "since", "until", "time_zone", "snapshot_through", "eligible_entities" ] } }, "required": [ "supported", "reason", "metric_key", "answer", "facts", "selection" ], "additionalProperties": false } }, "required": [ "id", "state", "question", "selection", "created_at", "updated_at", "cancel_requested", "transfer_state", "usage", "max_output_tokens", "error_code", "result" ] }, "tool": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "source_run_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "mode": { "type": "string", "enum": [ "assistant", "sandbox" ] }, "state": { "type": "string", "enum": [ "ready", "running", "awaiting_owner", "completed", "cancelled", "uncertain", "failed" ] }, "question": { "type": "string" }, "cancel_requested": { "type": "boolean" }, "deadline_at": { "type": "string" }, "model_steps": { "type": "integer", "minimum": 0, "maximum": 3 }, "tool_steps": { "type": "integer", "minimum": 0, "maximum": 4 }, "usage": { "type": "object", "properties": { "input_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "output_tokens": { "type": [ "integer", "null" ], "minimum": 0 }, "total_tokens": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "input_tokens", "output_tokens", "total_tokens" ], "additionalProperties": false }, "error_code": { "type": [ "string", "null" ] }, "checkpoint": { "type": "object", "properties": { "context": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "analytics-draft-proposal-v1" ] }, "source_run_id": { "type": "string", "format": "uuid" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "all", "instagram", "facebook", "threads", "x", "tiktok", "reddit", "snapchat", "youtube" ] }, "scope": { "type": "string", "minLength": 1, "maxLength": 512 }, "since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "current_since": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "until": { "type": "string", "format": "date-time", "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "time_zone": { "type": "string", "minLength": 1, "maxLength": 100 }, "view": { "type": "string", "enum": [ "accounts", "content" ] } }, "required": [ "workspaceId", "platform", "scope", "since", "current_since", "until", "time_zone", "view" ], "additionalProperties": false }, "summary": { "type": "string", "maxLength": 1200 }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "minItems": 1, "maxItems": 8 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 500 }, "effect": { "type": "string", "enum": [ "draft_only" ] }, "additional_model_calls": { "type": "number", "enum": [ 0 ] } }, "required": [ "version", "source_run_id", "selection", "summary", "facts", "targets", "effect", "additional_model_calls" ], "additionalProperties": false }, "proposal": { "type": "object", "properties": { "caption": { "type": "string", "maxLength": 2000 }, "fact_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "maxItems": 8 }, "brand_citation_ids": { "type": "array", "items": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "maxItems": 8 }, "effect": { "type": "string", "enum": [ "none" ] }, "editable": { "type": "boolean", "enum": [ true ] }, "recommendation": { "type": "boolean", "enum": [ true ] } }, "required": [ "caption", "fact_ids", "brand_citation_ids", "effect", "editable", "recommendation" ], "additionalProperties": false }, "answer": { "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "type": "string" }, "answer": { "type": "string" }, "facts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "provider": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" }, "period": { "type": "string", "enum": [ "current", "previous" ] }, "statistic": { "type": "string", "enum": [ "total", "median" ] }, "value": { "type": "number" }, "sample_size": { "type": "integer", "minimum": 0 }, "coverage": { "type": "object", "properties": { "eligible": { "type": "integer", "minimum": 0 }, "observed": { "type": "integer", "minimum": 0 }, "missing": { "type": "integer", "minimum": 0 } }, "required": [ "eligible", "observed", "missing" ] }, "measured_through": { "type": [ "string", "null" ] } }, "required": [ "id", "provider", "metric", "unit", "period", "statistic", "value", "sample_size", "coverage", "measured_through" ] }, "maxItems": 8 } }, "required": [ "supported", "reason", "answer", "facts" ], "additionalProperties": false }, "fixture": { "type": "object", "properties": { "evaluation": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "fixture" ] }, "model_calls": { "type": "number", "enum": [ 0 ] }, "live_effects": { "type": "number", "enum": [ 0 ] }, "quality_assessed": { "type": "boolean", "enum": [ false ] }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "passed": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [ "id", "passed", "reason" ], "additionalProperties": false } } }, "required": [ "mode", "model_calls", "live_effects", "quality_assessed", "checks" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "editable_brand_outline" ] }, "mode": { "type": "string", "enum": [ "fixture" ] }, "simulated": { "type": "boolean", "enum": [ true ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "current_version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "removed_at": { "type": [ "string", "null" ] }, "source_text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "citation_id": { "type": "string", "pattern": "^brand:[0-9a-f-]{36}$" }, "state": { "type": "string", "enum": [ "current_version", "superseded", "removed" ] } }, "required": [ "title", "version", "current_version", "kind", "removed_at", "source_text", "citation_id", "state" ], "additionalProperties": false }, "maxItems": 8 }, "source_run_id": { "type": "string", "format": "uuid" }, "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "kind", "mode", "simulated", "sections", "source_run_id", "snapshot_sha256" ], "additionalProperties": false } }, "required": [ "evaluation", "outline" ], "additionalProperties": false }, "draft": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "source_run_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "state": { "type": "string", "enum": [ "draft_created", "draft_removed" ] }, "receipt": { "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "audit_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string" }, "input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "created_at": { "type": "string" } }, "required": [ "command_id", "draft_id", "audit_id", "workspace_id", "input_hash", "created_at" ] }, "draft": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "base_caption": { "type": "string" }, "status": { "type": "string" }, "editorial_revision": { "type": "integer", "minimum": 0 }, "targets": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "maxItems": 1 } }, "required": [ "id", "base_caption", "status", "editorial_revision", "targets" ], "additionalProperties": false }, "proposal_caption": { "type": "string", "maxLength": 2000 }, "proposal_target": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "threads" ] }, "account_id": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "provider", "account_id" ], "additionalProperties": false }, "created_at": { "type": "string" }, "publication_authorized": { "type": "boolean", "enum": [ false ] } }, "required": [ "success", "source_run_id", "command_id", "workspace_id", "state", "receipt", "draft", "proposal_caption", "proposal_target", "created_at", "publication_authorized" ], "additionalProperties": false } }, "additionalProperties": false }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "source_run_id", "workspace_id", "mode", "state", "question", "cancel_requested", "deadline_at", "model_steps", "tool_steps", "usage", "error_code", "checkpoint", "created_at", "updated_at" ], "additionalProperties": false } }, "required": [ "id", "ordinal", "local_due", "due_at", "ask_run_id", "tool_run_id", "state", "error_code", "reserved_output_tokens", "observed_output_tokens", "ask", "tool" ], "additionalProperties": false }, "maxItems": 52 } }, "required": [ "id", "version", "workspace_id", "source_run_id", "definition", "definition_sha256", "paused", "revoked_at", "next_ordinal", "reserved_output_tokens", "created_at", "occurrences_loaded", "occurrence_count", "occurrences" ], "additionalProperties": false }, "maxItems": 100 }, "execution": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "operator_disabled", "model_not_configured", null ] } }, "required": [ "enabled", "reason" ], "additionalProperties": false } }, "required": [ "policies", "execution" ], "additionalProperties": false } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/v1/brand-knowledge": { "get": { "operationId": "readAutomationBrandKnowledge", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires automation:brand-knowledge:read and current exact target authority. Read the existing canonical object/history or recover the original command_id without another write. No provider/model effect, editorial approval or permission is supplied by the result. Removed or unconfirmed history does not permit recreation. Fresh selected-tool OAuth v3 binding is separate from old v1/v2 policies. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "required": true, "name": "workspaceId", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "id", "in": "query" }, { "schema": { "type": "string", "enum": [ "list", "retrieval", "history" ] }, "required": false, "name": "view", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "cursor", "in": "query" }, { "schema": { "type": "string", "format": "uuid" }, "required": false, "name": "command_id", "in": "query" } ], "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "receipt": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "revise", "remove" ] }, "source_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "created_at": { "type": "string" } }, "required": [ "id", "operation", "source_id", "version_id", "version", "created_at" ] }, "source": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "replayed": { "type": "boolean" } }, "required": [ "receipt", "source", "replayed" ] }, { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at" ] }, "maxItems": 32 }, "next_cursor": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "sources", "next_cursor" ] }, { "type": "object", "properties": { "source": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] } }, "required": [ "source" ] }, { "type": "object", "properties": { "source": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at" ] }, "versions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "source_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "source_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "source_id", "workspace_id", "version", "kind", "title", "text", "content_sha256", "created_at", "source_created_at", "removed_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "source", "versions", "model_transfer" ] }, { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-knowledge.retrieval.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "read_at": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "maxItems": 8 }, "selection": { "type": "string", "enum": [ "active_sources_by_id" ] }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "complete": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "schema", "workspace_id", "read_at", "sources", "selection", "total_available", "omitted", "complete", "reason", "model_transfer" ] }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } }, "post": { "operationId": "manageAutomationBrandKnowledge", "security": [ { "apiKey": [] }, { "agentOAuth": [] } ], "description": "Requires separately granted automation:brand-knowledge:read and automation:brand-knowledge:manage, current exact workspace/account targets and explicit confirm:true. Allowed canonical operations: create, revise, remove. Existing model-transfer, skill, media, finite budget, graph, review and scheduling consents remain mandatory. Generated drafts stay unapproved. An immutable original command_id binds the complete intention and original domain; revoked, changed, deleted or expired authority holds downstream work. Persist the original command UUID before POST. One deliberate submission only; GET with command_id recovers its exact original outcome. Unconfirmed model, save or scheduling effects never authorize replay. Fresh selected-tool OAuth v3 binding is supported independently; old v1/v2 bindings do not gain these actions. Fresh policy v3 management requires a separate immutable client registration and owner binding for this exact API resource, selected tool, same current finite grant actions and exact targets. The current tool catalog does not grant authority. Original command namespace and recovery are bound to the same registration/client/binding; old v1/v2 remain unchanged. Bearers for hosted MCP or another resource are not API credentials. Provider/customer effects and actual named-host activation remain separately observed states.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "command_id": { "type": "string", "format": "uuid" }, "confirm": { "type": "boolean", "enum": [ true ] }, "input": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string" }, "operation": { "type": "string", "enum": [ "create" ] }, "command_id": { "type": "string", "format": "uuid" }, "id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "title", "text", "operation", "command_id", "id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string" }, "operation": { "type": "string", "enum": [ "revise" ] }, "command_id": { "type": "string", "format": "uuid" }, "id": { "type": "string", "format": "uuid" }, "expected_version_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "title", "text", "operation", "command_id", "id", "expected_version_id" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "remove" ] }, "command_id": { "type": "string", "format": "uuid" }, "id": { "type": "string", "format": "uuid" }, "expected_version_id": { "type": "string", "format": "uuid" } }, "required": [ "operation", "command_id", "id", "expected_version_id" ], "additionalProperties": false } ] } }, "required": [ "workspaceId", "command_id", "confirm", "input" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Typed canonical result or explicit original unconfirmed outcome; Cache-Control:no-store", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "completed" ] }, "command_id": { "type": "string", "format": "uuid" }, "result": { "anyOf": [ { "type": "object", "properties": { "receipt": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "operation": { "type": "string", "enum": [ "create", "revise", "remove" ] }, "source_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "exclusiveMinimum": 0 }, "created_at": { "type": "string" } }, "required": [ "id", "operation", "source_id", "version_id", "version", "created_at" ] }, "source": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "replayed": { "type": "boolean" } }, "required": [ "receipt", "source", "replayed" ] }, { "type": "object", "properties": { "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at" ] }, "maxItems": 32 }, "next_cursor": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "sources", "next_cursor" ] }, { "type": "object", "properties": { "source": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] } }, "required": [ "source" ] }, { "type": "object", "properties": { "source": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at" ] }, "versions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "source_id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 120 }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "source_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] } }, "required": [ "id", "source_id", "workspace_id", "version", "kind", "title", "text", "content_sha256", "created_at", "source_created_at", "removed_at" ], "additionalProperties": false }, "minItems": 1, "maxItems": 64 }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "source", "versions", "model_transfer" ] }, { "type": "object", "properties": { "schema": { "type": "string", "enum": [ "juno.brand-knowledge.retrieval.v1" ] }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "read_at": { "type": "string" }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "guideline", "faq" ] }, "title": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1, "maximum": 64 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "version_created_at": { "type": "string" }, "removed_at": { "type": [ "string", "null" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "id", "workspace_id", "kind", "title", "version_id", "version", "content_sha256", "created_at", "updated_at", "version_created_at", "removed_at", "text" ] }, "maxItems": 8 }, "selection": { "type": "string", "enum": [ "active_sources_by_id" ] }, "total_available": { "type": "integer", "minimum": 0 }, "omitted": { "type": "integer", "minimum": 0 }, "complete": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "enum": [ "source_count_limit", "text_character_limit", null ] }, "model_transfer": { "type": "string", "enum": [ "not_authorized" ] } }, "required": [ "schema", "workspace_id", "read_at", "sources", "selection", "total_available", "omitted", "complete", "reason", "model_transfer" ] }, { "type": "object", "properties": { "removed": { "type": "boolean", "enum": [ true ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "removed" ], "additionalProperties": false } ] } }, "required": [ "success", "state", "result" ], "additionalProperties": false }, { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] }, "state": { "type": "string", "enum": [ "unconfirmed" ] }, "command_id": { "type": "string", "format": "uuid" }, "resource": { "type": "string", "enum": [ "analytics-portfolio", "analytics-skills", "analytics-skill-preparation", "analytics-skill-recurring-preparation", "media-draft-plan", "analytics-result-suggestions", "reviewed-queue-fill", "social-workflow", "analytics-ask", "analytics-tool-run", "analytics-recurring", "brand-knowledge" ] }, "domain_id": { "type": [ "string", "null" ], "format": "uuid" }, "recovery_required": { "type": "boolean", "enum": [ true ] } }, "required": [ "success", "state", "command_id", "resource", "domain_id", "recovery_required" ], "additionalProperties": false } ] } } } }, "400": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "401": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "403": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "405": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "410": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "422": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "429": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } }, "503": { "description": "Invalid, denied, changed, removed or unavailable original. Unknown writes require original command GET recovery; never automatic resend.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "required": [ "error" ] } } } } } } } }, "webhooks": {} }